Guide

Rate limits & contracts

Quotas, concurrency and contract limits.

Your plan (contract) determines how much you can do: file sizes, daily budgets, and how many conversions can run at once.

Free tier

Every registered user gets 30 free credits every 24 hours. Conversions consume credits; once the day's free credits are used up, further conversions return 402 Payment Required until the 24-hour window resets — or you add a paid plan for higher quotas.

Inspect your limits

GET /v2/contracts returns the contracts and limits attached to your API key.

curl https://api.api2convert.com/v2/contracts \
  -H "x-oc-api-key: <your-api-key>"

Concurrency

Each contract caps the number of concurrent conversions. Exceeding it returns 429 Too Many Requests — back off and retry. List endpoints return the total count in the X-Count header.

Quotas

Exceeding your contract's budget (e.g. monthly minutes or credits) returns 402 Payment Required. Free keys have tighter limits, including the number of inputs per job and maximum file size.

Pagination

Listing endpoints (e.g. GET /v2/jobs) return up to 50 items per page. Use ?page=N to page through results.

Best practices

Use webhooks instead of tight polling loops.
On 429, retry with exponential backoff.
Track usage with the statistics endpoints.