Skip to main content

HTTP errors

Our API follows a predictable HTTP error code format:
  • 400 - invalid_request_error: There was an issue with the format or content of your request. We may also use this error type for other 4XX status codes not listed below.
  • 401 - authentication_error: There’s an issue with your API key.
  • 403 - permission_error: Your API key does not have permission to use the specified resource.
  • 404 - not_found_error: The requested resource was not found.
  • 413 - request_too_large: Request exceeds the maximum allowed number of bytes.
  • 429 - rate_limit_error: Your account has hit a rate limit.
  • 500 - api_error: An unexpected error has occurred internal to Datalab’s systems.
  • 529 - overloaded_error: API is temporarily overloaded.

Subscription and Access Errors

When making API requests, you may encounter 403 errors related to your subscription status:

No Active Subscription

Error: “You need an active, paid subscription to use this API.” This occurs when you don’t have an active subscription and have exhausted your free credits. To resolve:
  • Subscribe to a paid plan in the dashboard
  • Add credits to your account if you’re a new user

Expired Subscription

Error: “Your subscription has expired. You may need to re-enable your plan, or pay an unpaid invoice.” Your subscription has passed its end date and grace period. To resolve:
  • Renew your subscription in the dashboard
  • Pay any outstanding invoices
  • Contact support if you believe this is an error

Payment Failed

Error: “Your payment has failed. Please pay any unpaid invoices to continue using the API.” A payment for your subscription has failed and you’ve exceeded the grace period. To resolve:
  • Update your payment method in the dashboard
  • Pay any unpaid invoices
  • Contact support for assistance

Inactive Subscription

Error: “Your subscription is not active. You may need to re-enable your plan or pay an unpaid invoice.” Your subscription is canceled or inactive. To resolve:
  • Reactivate your subscription in the dashboard
  • Subscribe to a new plan
  • Pay any outstanding invoices