prepaid.ai docs
StatusOpen the console
API referencePlan, call detail, messages, bookings, questions, contacts

Plan, call detail, messages, bookings, questions, contacts

The rest of what an agent or an automation can read — the same answers the MCP tools give.

Each of these answers from the same code as the matching MCP tool, so a script and an AI assistant reading one workspace are always told the same thing. All are read-only and take the same bearer key.

GET/api/v1/plan

The plan, its status and expiry, days left, and plan minutes left of the total. `plan` is `null` on the free tier.

GET/api/v1/calls/[id]

One call in full: details, summary, the transcript turn by turn, and any message taken. 404 for a call this workspace does not hold.

GET/api/v1/messages

Messages your AI took and calls it flagged urgent, newest first.

FieldTypeDescription
limitoptionalinteger1–200, default 50.
urgent_onlyoptionalbooleantrue for only the calls flagged urgent.
GET/api/v1/bookings

Appointments from now until `days_ahead` days ahead, soonest first, and who made each one (`ai`, `booking_page` or `owner`).

FieldTypeDescription
days_aheadoptionalinteger1–90, default 14.
GET/api/v1/questions

Questions callers asked that your AI could not answer, most-asked first.

FieldTypeDescription
include_answeredoptionalbooleantrue to include ones already answered or dismissed.
GET/api/v1/contacts

Saved contacts, optionally filtered.

FieldTypeDescription
searchoptionalstringPart of a name, phone number, email or company.
limitoptionalinteger1–200, default 50.
Request
curl "https://app.prepaid.ai/api/v1/messages?urgent_only=true" \
  -H "Authorization: Bearer pk_live_your_key_here"
NoteTimes are ISO 8601 in UTC. A value we do not have is null, never a guess.