Error Codes – APIVult

Docs

Error Codes

Standard error codes returned by all APIVult APIs.

All APIVult APIs use standard HTTP status codes and return a consistent JSON error structure.

Error Response Format

{
  "error": "validation_error",
  "message": "The 'value' field is required.",
  "field": "value",
  "status": 400
}

Status	Meaning
`200`	Success
`400`	Bad Request — invalid or missing parameters
`401`	Unauthorized — missing or invalid API key
`403`	Forbidden — key valid but not subscribed to this API
`422`	Unprocessable Entity — request format valid but content failed validation
`429`	Too Many Requests — rate limit exceeded
`500`	Internal Server Error — contact support if persistent
`503`	Service Unavailable — temporary outage

Error Code	Status	Description
`missing_field`	400	A required field was not provided
`invalid_type`	400	The `type` parameter value is not supported
`invalid_format`	400	Request body is not valid JSON
`unauthorized`	401	`X-API-Key` header missing or invalid
`forbidden`	403	API key not subscribed to this endpoint
`validation_failed`	422	Input data did not pass validation rules
`rate_limit_exceeded`	429	Monthly or per-minute quota exceeded
`internal_error`	500	Unexpected server error

Check your API key — ensure X-API-Key is present and correct
Verify subscription — confirm you are subscribed to the specific API on the APIVult dashboard
Validate request body — all endpoints expect Content-Type: application/json
Check rate limits — review X-RateLimit-Requests-Remaining in response headers

For persistent errors, contact [email protected] with your request ID.