canonical: https://jentic.com/apis/reloadly.com/reloadly

# Reloadly topupsapi

The topupsapi spec listed under Reloadly describes a small polls service: it publishes poll questions with a set of answer choices and lists the questions already published, each with its choices, vote counts, and published_at timestamp. Despite the name, the operations in this spec cover polls only, served from polls.apiblueprint.org, and contain no airtime or mobile top-up functions. Treat it as a reference polls API for prototyping question-and-choice flows.

## For AI agents

Publish a poll question with answer choices and list existing questions with their per-choice vote counts.

## Scope

Does not handle mobile airtime top-ups, vote casting, or survey response collection. Use for publishing and listing poll questions only.

## Capabilities

- Publish a poll question with an array of answer choices
- List published poll questions with each choice's vote count
- Read the published_at timestamp of each poll question

## Use cases

### Agent runs a quick team poll

An agent connected through Jentic publishes a question with its choices in one call, then later lists the questions to read back the votes recorded against each choice and report the leader. The spec has no vote-casting operation, so the agent reports on votes rather than casting them.

Example prompt: Call POST /questions with question set to 'Favourite programming language?' and choices set to Swift, Python, Objective-C, and Ruby, then call GET /questions to read the vote counts

### Prototype a question-and-choice flow

Developers building a survey or poll feature use this compact spec to test a create-and-list loop: a POST that takes a question string and choices array, and a GET that returns each question with choice objects carrying choice and votes fields.

Example prompt: Call POST /questions with a test question and two choices, then call GET /questions and confirm the new question appears with votes at 0

### Poll results digest

A scheduled job lists all published questions and turns the votes on each choice into a short digest, sorted by published_at, for a chat channel or report.

Example prompt: Call GET /questions, sort the questions by published_at, and report the choice with the most votes for each

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/questions` | List all poll questions with vote counts |
| POST | `/questions` | Publish a new poll question with choices |

## Key resources

- **Questions** — Poll questions with a choices array; each choice carries choice text and votes

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 45 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 90 / 100
  - Developer Experience & Jentic Compatibility: 65 / 100
  - AI-Readiness & Agent Experience: 18 / 100
  - Agent Usability: 94 / 100
  - Security: 100 / 100
  - AI Discoverability: 100 / 100
- **View full report:** https://jentic.com/apis/reloadly.com/reloadly/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring topupsapi by hand means finding its polls.apiblueprint.org host and the question and choices body shape from an Apiary document. Through Jentic you install once, import it from the API Directory, and your agent calls it with the schema already loaded.
- **Permission scoping:** Both operations share the /questions path and differ only by method, so a rule can separate reading polls from publishing them: your agent may list questions without being able to create one unless you add POST.
- **Credential handling:** This spec declares no security scheme, so there is nothing secret to hold and nothing sensitive enters the agent's prompt, logs, or context. Calls run from your own Jentic One instance.
- **Discovery method:** Agents search Jentic by intent such as 'create a poll' or 'list poll questions', and Jentic returns the matching operation with its input schema so the agent sends the right question and choices fields.

## Related APIs

- **Typeform API** — Forms and surveys with response collection
- **SurveyMonkey API** — Survey creation and response analysis
- **JotForm API** — Online forms and submissions

## FAQ

### Does the topupsapi spec include mobile top-ups?

No. Although it is listed under Reloadly with the title topupsapi, its two operations publish and list poll questions on polls.apiblueprint.org. For airtime or top-up operations, look for a different Reloadly spec.

### What authentication does the topupsapi use?

Per its OpenAPI spec, topupsapi declares no security scheme, and neither GET /questions nor POST /questions lists a credential.

### How do I create a poll question with the topupsapi?

Send POST /questions with a JSON body containing question, a string, and choices, an array of strings. The 201 response returns the question with each choice set to 0 votes and a published_at timestamp, plus a Location header.

### Can I cast a vote with the topupsapi?

Not through this spec. It defines listing and creating questions only; vote counts appear in the GET /questions response but no operation records a vote.

### What are the rate limits for the topupsapi?

The OpenAPI spec does not specify rate limits. Check https://topupsapi.docs.apiary.io for the source documentation.

### How do I list poll results through Jentic?

Search Jentic for 'list poll questions'. It returns the GET /questions operation, your agent calls it, and reads the votes on each choice. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Can I limit what my agent is allowed to do with the topupsapi?

Yes. Allow only GET /questions and a reporting agent can read polls and their votes but cannot publish a new question. Add POST /questions only for an agent that should create polls.
