Errors

When a request fails, the API returns a JSON error object with a machine-readable code, a human-readable message, and the HTTP status code.

Error format

{
  "error": "ERROR_CODE",
  "message": "A description of what went wrong",
  "statusCode": 400
}

Code	Status	Description
`INVALID_REQUEST`	400	The request is missing required fields or contains invalid values.
`UNAUTHORIZED`	401	The API key is missing, invalid, or inactive.
`PAYMENT_REQUIRED`	402	Your account credit balance is at or below zero. Top up to resume submitting jobs.
`FORBIDDEN`	403	The API key is valid but lacks the scope the endpoint requires.
`ACCOUNT_TERMINATED`	403	Your account has been terminated. Contact support.
`JOB_NOT_FOUND`	404	The job ID does not exist or belongs to a different account.
`RATE_LIMITED`	429	You have exceeded your per-client rate limit. See rate limiting.
`INTERNAL_ERROR`	500	An unexpected server error occurred. Retry after a short delay.
`SERVICE_UNAVAILABLE`	503	Moderation intake is busy, or a downstream dependency is temporarily unavailable. Capacity rejections carry a `Retry-After` header, in seconds.
`SUBMISSION_STATUS_UNKNOWN`	503	The submission may have been accepted, but the API could not confirm it. The body carries a `job_id`.

400: Check your request body, query parameters, or file uploads against the API reference.
401: Verify your API key is correct and active.
402: Your credit balance has hit zero or gone negative. Sign in to the dashboard and top up.
403 FORBIDDEN: Your key is missing a required scope. See scopes.
403 ACCOUNT_TERMINATED: Your account has been permanently terminated. This is not recoverable via the API.
404: Confirm the job ID is correct and was created under your account.
429: Back off and retry. Use exponential backoff with jitter.
500/503: Retry after a short delay. If the error persists, contact support@omnifence.ai.
503 SERVICE_UNAVAILABLE: When the response carries Retry-After, wait at least that many seconds, then retry with exponential backoff and jitter.
503 SUBMISSION_STATUS_UNKNOWN: Do not resubmit immediately. The response body carries the job_id of the submission whose outcome is unknown. Poll GET /api/v1/job/{job_id}: a job that exists was accepted and is running; a JOB_NOT_FOUND means the submission was rejected and you can safely submit again. Resubmitting without polling can create a second job for the same content, and you pay for both.