Response Codes

HTTP status codes and machine-readable error identifiers.

HTTP status codes

Code	Name	Description
200	OK	Request succeeded. The response body contains the data envelope.
201	Created	A resource was created (account, API key, or conversion record).
400	Bad Request	Malformed request, invalid body fields, missing file, or validation failure.
401	Unauthorized	Missing, invalid, or expired credentials.
402	Payment Required	The account does not have enough credits for the conversion.
403	Forbidden	Authenticated but not allowed (e.g. API keys require a paid plan, guest quota exceeded).
404	Not Found	Route, resource, or file does not exist or is not owned by you.
413	Payload Too Large	The uploaded file exceeds the allowed size for your plan or the converter.
422	Unprocessable Entity	The requested input-to-output conversion is not supported, or the uploaded file's format does not match this conversion endpoint.
429	Too Many Requests	Rate limit exceeded. The Retry-After header indicates when to retry.
500	Internal Server Error	An unexpected server error occurred. Retry later or contact support.

Code	Status	Description
VALIDATION_ERROR	400	Request body failed schema validation. Check the details field for the offending fields.
UNSUPPORTED_FILE_TYPE	400	The uploaded file's extension is not a recognized input format.
NO_FILE	400	The multipart upload contained no file.
UNEXPECTED_FILE	400	More than one file was uploaded to a single-file field.
UPLOAD_ERROR	400	The multipart upload failed for an unknown reason.
INVALID_FILE_KEY	400	The download key is not a valid storage key.
UNAUTHORIZED	401	No token provided, or the token could not be verified.
API_KEYS_REQUIRE_PAID_PLAN	403	API keys are a paid feature; the account is on a plan without API access.
GUEST_QUOTA_EXCEEDED	403	Guest daily conversion quota reached. Sign in to continue.
ACCESS_DENIED	403	The resource belongs to another account.
PAYMENT_REQUIRED	402	Insufficient credits for the conversion. Top up or upgrade.
FILE_TOO_LARGE	413	File exceeds the plan or converter size limit.
GUEST_FILE_TOO_LARGE	413	File exceeds the guest 5MB limit; sign in to upload larger files.
UNSUPPORTED_FORMAT	422	The input-to-output conversion is not supported, or the file's format does not match the conversion endpoint.
UNKNOWN_CONVERSION	404	The conversion endpoint slug does not exist (e.g. POST /converter/nope).
API_KEY_LIMIT_REACHED	403	The plan's API key allowance is exhausted; revoke a key or upgrade.
NOT_FOUND	404	Resource does not exist or is not visible to the caller.
TOO_MANY_REQUESTS	429	Rate limit exceeded.
INTERNAL_ERROR	500	Unexpected server error.