API reference
Errors & limits
Status codes, rate limiting, idempotency, and account info.
Status codes
Common responses
200 / 201 | OK | Success; 201 when a resource is created. |
400 | Bad Request | Body or query failed validation. |
401 | Unauthorized | Missing or invalid API key / token. |
402 | Payment Required | Insufficient credits. |
403 | Forbidden | Missing scope or plan limit reached. |
404 | Not Found | Resource does not exist (or result not ready). |
429 | Too Many Requests | Rate limited; retry after a short delay. |
502 | Bad Gateway | A dependency (conversion, billing) is unavailable. |
Rate limits & idempotency
Requests are rate limited per account. On a 429, back off and retry. Credit-spending POSTs accept an Idempotency-Key header so a retried request replays the original response instead of charging twice.
Account
GET
https://api.markitdown.ai/meThe authenticated accountGET
https://api.markitdown.ai/usageCredit usage and limits