✛ 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 us
  • X-Units · units delivered
  • X-Charged-Usd · what this call cost

3 · Errors

Errors are application/problem+json (RFC 9457) with a stable type URL.

StatusMeaningCharged?
400The input is invalid; detail says which field.No
401Missing, unknown or revoked key.No
402Not enough credit for the quoted price.No
403key_budget_too_small: the call costs more than the key's whole daily budget.No
409The same Idempotency-Key is still running. Retry after the Retry-After seconds.No
413The request body is over 2 MiB.No
422Idempotency-Key reused with a different body.No
429budget_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.
500Our fault. Quote the X-Request-Id.No Refunded
503engine_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

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.