Errors

ApiMask endpoint responses use a consistent JSON envelope when the request reaches the ApiMask API:

{
  "success": false,
  "data": null,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your rate limit. Retry after 60 seconds.",
    "retry_after": 60
  },
  "meta": { "request_id": "req_xyz456" }
}

Common error codes

Code	HTTP	Meaning
`UNAUTHORIZED`	401	Missing, invalid, or unsubscribed RapidAPI credentials.
`RATE_LIMIT_EXCEEDED`	429	Too many requests for the active RapidAPI plan.
`INVALID_REQUEST`	400	Request body failed validation.
`INTERNAL_ERROR`	500	Unexpected server error.

RapidAPI errors

RapidAPI may return its own 401, 403, or 429 response before the request reaches ApiMask. In that case, check the subscription, X-RapidAPI-Key, X-RapidAPI-Host, and plan quota in your RapidAPI dashboard.

Pricing Limits on RapidAPI