✛ Docs
Quickstart
Everything you need fits on one page.
1 · Get a key
Sign in with your email and create a key on your account page. During the private beta, credit is added by hand: reply to your sign-in email to ask for some. Keys look like rdy_ followed by 40 characters. We store only a hash; copy it when it is shown.
2 · Call an API
Send JSON with your key as a bearer token (or in X-Api-Key).
curl https://readymadeapi.com/v1/business-days/add \
-H "Authorization: Bearer $READYMADE_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "RO", "date": "2026-12-23", "days": 3}'Every response carries:
X-Request-Id· quote it when you contact usX-Units· units deliveredX-Charged-Usd· what this call cost
3 · Errors
Errors are application/problem+json (RFC 9457) with a stable type URL.
| Status | Meaning | Charged? |
|---|---|---|
| 400 | The input is invalid; detail says which field. | No |
| 401 | Missing, unknown or revoked key. | No |
| 402 | Not enough credit for the quoted price. | No |
| 403 | key_budget_too_small: the call costs more than the key's whole daily budget. | No |
| 409 | The same Idempotency-Key is still running. Retry after the Retry-After seconds. | No |
| 413 | The request body is over 2 MiB. | No |
| 422 | Idempotency-Key reused with a different body. | No |
| 429 | budget_spent: the key's daily budget is used up until midnight UTC (you can set one when you create a key). too_many_in_flight: more than 2 calls at once per key across engine-backed APIs. site_busy: the site a URL points at is being asked too often; retry after the Retry-After seconds. | No too_many_bad_keys: 30 requests with a missing or invalid key from one address in a minute; wait out Retry-After. |
| 500 | Our fault. Quote the X-Request-Id. | No Refunded |
| 503 | engine_busy or unavailable: the engine is at capacity or a service is away. Retry after the Retry-After seconds. not_configured: this API cannot run here yet; retrying will not help. upstream_failed, upstream_timeout or timeout: a model or site behind the API failed or took too long. | No Refunded |
4 · Retries
Send Idempotency-Key: <your id> with any call. A repeat with the same key and body returns the stored response and is not charged again. A failed call releases the key so you can retry it.
5 · MCP
Every endpoint is also an MCP tool on https://readymadeapi.com/mcp (Streamable HTTP). Add it to your client, or follow the Connect guide for Claude Code and others:
{
"mcpServers": {
"readymade": {
"type": "http",
"url": "https://readymadeapi.com/mcp",
"headers": {
"Authorization": "Bearer ${READYMADE_KEY}"
}
}
}
}6 · Machine-readable
- /openapi.json · OpenAPI 3.1 for every endpoint
- /llms.txt · a plain-text summary for language models
7 · Long jobs
Audio and other long work answers 202 with a job_id. The whole quote is charged then, and whatever doesn't run is refunded: unused minutes, a failure, or a missed deadline. Poll GET /v1/jobs/{id}; the result appears in it when the job finishes, and is kept for 7 days. Polling is free. Agents use the get_job tool.