Error Codes

When an error occurs, RenderScreenshot returns an appropriate HTTP status code and a JSON error response.

Error Response Format

{
  "error": {
    "code": "invalid_url",
    "message": "The provided URL is not valid",
    "details": {}
  }
}

Invalid request parameters.

Code	Description
`invalid_url`	The URL is malformed or missing
`invalid_parameter`	A parameter has an invalid value
`missing_parameter`	A required parameter is missing

Authentication failed.

Code	Description
`missing_api_key`	No API key provided
`invalid_api_key`	API key is invalid or revoked
`expired_signature`	Signed URL has expired
`invalid_signature`	Signature verification failed

Access denied.

Code	Description
`blocked_url`	The target URL is blocked
`quota_exceeded`	Monthly screenshot quota exceeded

Resource not found.

Code	Description
`page_not_found`	Target URL returned 404

The request took too long.

Code	Description
`render_timeout`	Screenshot rendering timed out

Rate limit exceeded.

Code	Description
`rate_limit_exceeded`	Too many requests per minute

Server-side error.

Code	Description
`render_failed`	Screenshot rendering failed
`internal_error`	Unexpected server error

curl https://api.renderscreenshot.com/v1/screenshot \
  -H "Authorization: Bearer invalid_key"

Response (401):

{
  "error": {
    "code": "invalid_api_key",
    "message": "The provided API key is invalid"
  }
}