| ECONNRESET |
Error: socket hang up / read ECONNRESET |
The other side closed the TCP connection abruptly while your client was still using it. |
| ETIMEDOUT |
API Request Timed Out (ETIMEDOUT / ReadTimeout / timeout of 30000ms exceeded) |
The client gave up waiting — either for the connection to open or for the response to arrive. |
| invalid_api_key |
API Error: Invalid API Key / Incorrect API key provided |
The API didn’t recognise the key sent with the request — it’s wrong, revoked, from another environment, or se… |
| tlsv1 alert protocol version |
SSL error: tlsv1 alert protocol version / unsupported protocol / no protocols available |
The client and server couldn’t agree on a TLS version or cipher, so the HTTPS handshake failed before any HTT… |
| file_type_not_allowed |
Upload error: File type not allowed / unsupported file type |
The upload was rejected because the file’s type — extension, MIME type or actual content — isn’t on the allow… |
| additionalProperties |
API Error: Request failed schema validation (must NOT have additional properties / Additional properties are not allowed) |
The JSON body doesn’t match the endpoint’s schema — an unknown property, wrong nesting, or a missing required… |
| API-005 |
API Service Unavailable |
The API service is temporarily unable to process requests because the service is unavailable, overloaded, or… |
| invalid_id |
API Error: Invalid ID format (not a valid UUID / malformed identifier) |
An ID in the URL or body doesn’t have the shape the API expects — a malformed UUID, wrong prefix, or an ID ma… |
| CORS |
CORS Error: No 'Access-Control-Allow-Origin' header is present |
The browser blocked a cross-origin request because the server’s response didn’t include the CORS headers allo… |
| ENOTFOUND |
Error: getaddrinfo ENOTFOUND host / Name or service not known |
DNS lookup for the hostname failed — the name is wrong, doesn’t exist, or this machine can’t resolve it. |
| LIMIT_FILE_SIZE |
Upload error: File too large (LIMIT_FILE_SIZE / file exceeds maximum upload size) |
The uploaded file is larger than the limit set by the API, framework or server. |
| 14 UNAVAILABLE |
gRPC Error: 14 UNAVAILABLE: No connection established / failed to connect to all addresses |
The gRPC client couldn’t reach the server — wrong address/port, TLS vs plaintext mismatch, server down, or a… |
| API-002 |
Invalid Request |
The API rejected the request because one or more parameters, headers, fields, or request values are invalid o… |
| overloaded_error |
LLM API: overloaded_error (529) / The server is overloaded / Service unavailable — model temporarily overloaded |
The provider is temporarily at capacity; the request was rejected even though your key and quota are fine. |
| feature_not_enabled |
API Error: Feature not enabled for this account (feature_not_enabled / not available on your plan) |
The endpoint or option exists, but your account, plan, region or project hasn’t been granted access to it. |
| invalid_date |
API Error: Invalid date format — expected ISO 8601 (YYYY-MM-DDTHH:mm:ssZ) |
A date or timestamp in the request isn’t in the format the API expects — usually ISO 8601 with a time zone, o… |
| invalid_value |
API Error: Invalid parameter value — must be one of the allowed values / out of range |
The field has the right type but a value the API doesn’t allow — not in the list of accepted options, too sma… |
| unexpected_state |
API Error: Invalid state transition — operation not allowed in the resource’s current state |
The request is valid, but the object is in a state where this action isn’t allowed — cancelling something alr… |
| invalid_type |
API Error: Invalid type — expected integer, received string |
A request field has the wrong data type — a string where the API expects a number, a number where it expects… |
| GRAPHQL_VALIDATION_FAILED |
GraphQL: Cannot query field "x" on type "Y" |
The query asks for a field that doesn’t exist in the server’s schema (or isn’t available on that type). |
| DEADLINE_EXCEEDED |
gRPC Error: 4 DEADLINE_EXCEEDED: Deadline exceeded |
The call didn’t complete before the client’s deadline — slow server, network issues, or a deadline that’s too… |
| Failed to load API definition |
Swagger UI: Failed to load API definition. Fetch error: Internal Server Error /swagger/v1/swagger.json |
Swagger UI couldn’t fetch or parse the OpenAPI document — the generator threw an error, the URL is wrong, or… |
| idempotency_key_in_use |
API Error: Idempotency key reused with different parameters (idempotency_key_in_use) |
An Idempotency-Key header was sent again with a different request body, or while the first request with that… |
| api_version_invalid |
API Error: Invalid or unsupported API version |
The API version you requested — in the URL, a header or the SDK config — doesn’t exist or has been retired. |
| entity.parse.failed |
API Error: Malformed JSON in request body (entity.parse.failed / JSON parse error) |
The server couldn’t parse the request body as JSON, so it rejected the request before looking at any field. |
| ALREADY_EXISTS |
API Error: Resource already exists (ALREADY_EXISTS / resource_already_exists / 409) |
The create request was refused because an object with the same unique identity — name, email, external ID — a… |
| RefererNotAllowedMapError |
Google Maps: This API project is not authorized to use this API / RefererNotAllowedMapError / ApiNotActivatedMapError |
The Maps API key isn’t allowed for this site/API — the API isn’t enabled, the referrer restriction doesn’t in… |
| SOAP-ERROR: Parsing WSDL |
SOAP-ERROR: Parsing WSDL: Couldn't load from 'https://x?wsdl' / SoapFault |
The SOAP client couldn’t download or parse the WSDL — network/TLS issues, wrong URL, authentication, or inval… |
| No API key provided |
Stripe: You did not provide an API key. You need to provide your API key in the Authorization header |
The request reached the API without an API key — the environment variable wasn’t loaded or the SDK wasn’t ini… |
| BadDigest |
Upload error: checksum mismatch (BadDigest / Content-MD5 did not match / XAmzContentSHA256Mismatch) |
The server computed a different checksum for the data it received than the one your client declared, so it re… |
| webhook delivery failed |
Webhook delivery failed (endpoint returned non-2xx / timed out) |
The provider tried to send a webhook to your endpoint but didn’t get a timely 2xx response, so it marks the d… |
| test/live mismatch |
API Error: a similar object exists in test mode, but a live mode key was used |
You’re using an ID, key or URL from one environment (test/sandbox) with credentials from another (live/produc… |
| Cannot GET |
API Error: Cannot GET /api/... / No route matches / The route could not be found |
The server has no route for this URL and HTTP method combination — the endpoint path, API version prefix or m… |
| concurrent_requests_limit |
API Error: Too many concurrent requests (concurrency limit reached) |
You have more requests in flight at once than the API allows for your key — even if your requests-per-minute… |
| Mixed Content |
Mixed Content: The page was loaded over HTTPS, but requested an insecure resource |
An HTTPS page tried to load a script, API or image over plain HTTP, and the browser blocked (or warned about)… |
| OptimisticLockException |
Optimistic lock conflict: OptimisticLockException / StaleObjectStateException / version mismatch |
Someone else changed the record after you read it, so your update — based on an old version — was rejected to… |
| parameter_missing |
API Error: Missing required parameter (parameter_missing / "x" is required) |
The API rejected the request because a field it requires — in the query string, path, headers or JSON body —… |
| GraphQL Syntax Error |
GraphQL: Syntax Error: Expected Name, found <EOF> / Unexpected } |
The GraphQL document is malformed — unbalanced braces, a stray comma/character, or an empty query. |
| 12 UNIMPLEMENTED |
gRPC Error: 12 UNIMPLEMENTED: unknown service x / Method not found |
The server doesn’t have the service or method the client called — proto mismatch, wrong package name, or call… |
| CERTIFICATE_VERIFY_FAILED |
SSL: CERTIFICATE_VERIFY_FAILED / unable to get local issuer certificate |
The client couldn’t verify the server’s TLS certificate chain, so it refused the HTTPS connection. |
| resource_missing |
API Error: No such object / resource_missing (resource not found by ID) |
The endpoint exists, but the ID you passed — in the URL or as a reference in the body — doesn’t match any rec… |
| query is too complex |
GraphQL: Query is too complex / exceeds maximum operation depth / complexity limit |
The server rejected the query because it’s too deep or too expensive according to its depth/complexity limits. |
| Variable of required type was not provided |
GraphQL: Variable "$id" of required type "ID!" was not provided. |
A GraphQL operation declares a non-null variable, but the request didn’t include a value for it. |
| model_not_found |
LLM API: The model `x` does not exist or you do not have access to it (model_not_found / not_found_error) |
The model name is wrong, deprecated/retired, or not available to your account/region. |
| context_length_exceeded |
LLM API: This model's maximum context length is x tokens. However, your messages resulted in y tokens (context_length_exceeded / prompt is too long) |
The prompt plus requested output exceed the model’s context window. |
| insufficient_quota |
LLM API: You exceeded your current quota, please check your plan and billing details (insufficient_quota / credit balance is too low) |
The account has no remaining credits or reached its spending limit, so requests are rejected (often as 429). |
| job not found |
API Error: Job / operation not found or expired (async task ID unknown) |
The status URL or job ID for an asynchronous operation (export, import, render, batch) doesn’t exist any more… |
| Cannot return null for non-nullable field |
GraphQL: Cannot return null for non-nullable field Query.user |
A resolver returned null (or threw) for a field the schema marks as non-null (!), so GraphQL nulls out the pa… |
| API-004 |
Unsupported Media Type |
The API cannot process the request because the media type or Content-Type format is not supported by the endp… |
| limit too large |
API Error: limit must be less than or equal to 100 (page size exceeds maximum) |
You asked for more items per page than the endpoint allows. |
| Received message larger than max |
gRPC Error: 8 RESOURCE_EXHAUSTED: Received message larger than max (x vs. 4194304) |
A gRPC message exceeded the receiver’s maximum size (4 MB default). |
| API-003 |
Rate Limit Exceeded |
The API rejected the request because the client has exceeded the allowed number of requests within a specifie… |
| webhook signature |
Webhook signature verification failed (Stripe, Razorpay, GitHub…) |
Your endpoint computed a different HMAC signature than the one the provider sent, so the webhook is rejected. |
| invalid_cursor |
API Error: Invalid pagination cursor (invalid_cursor / cursor expired) |
The page token or cursor you passed is malformed, expired, or was generated for a different query. |