Error Codes
The DomShot API uses standard HTTP status codes and returns structured error objects.Error response format
All errors return a JSON object with the following structure:Error codes
401 Unauthorized
invalid_token
Invalid or expired API key.inactive_subscription
No active subscription found.402 Payment Required
insufficient_balance
Free tier balance exhausted.429 Rate Limit Exceeded
rate_limit_exceeded
Too many requests within the rate limit window.retryAfter or upgrade your plan for higher limits.
500 Internal Server Error
screenshot_failed
Screenshot generation failed.- Target URL is unreachable
- Page timeout
- Invalid URL
- Internal server error