Errors and troubleshooting
Interpret API errors and resolve common Playground failures.
| Status | Meaning | Action |
|---|---|---|
400 |
The range is reversed (INVALID_MONTH_RANGE) or exceeds 24 months (MONTH_RANGE_TOO_LARGE). |
Correct the sales-month range and split longer exports into requests of at most 24 months. |
401 |
The Bearer header is missing, malformed, or invalid. | Verify the header and current key. |
422 |
A date or segment value is missing or invalid. |
Use ISO dates and normal, sample, or all. |
429 |
The shared key exceeded 30 requests in 60 seconds (RATE_LIMIT_EXCEEDED). |
Wait for the number of seconds in the Retry-After response header before retrying. |
503 |
The external API key is not configured on the service. | Contact Mellow; retrying with another key will not help. |
504 |
The database query exceeded 30 seconds (QUERY_TIMEOUT). |
Retry later or request a smaller sales-month range. If it persists, contact Mellow. |
Rate-limit retries
The v1 key has a process-wide limit of 30 authenticated requests per 60-second window. Invalid keys return 401 and do not consume this quota. When a request returns 429, honor Retry-After; immediate retries will continue to fail until the window resets.
Browser reports a CORS error
The live Playground is authorized only from https://docs.mellow.billgateai.com. Requests copied into another website or a local HTML page are intentionally blocked by the browser. Use curl or another server-side HTTP client outside the official documentation site.
The response contains null
This is not a transport error. It means that cost is unavailable under the same coverage rules used by the product-profit page. See Cost semantics.