Errors
HTTP status codes and error shapes returned by the Stream API.
Error shape
JSON
{
"isSuccess": false,
"error": "Rate limit exceeded for Community. Try again in a minute.",
"status": 429
}Failed requests return a JSON body with isSuccess: false and a human-readable error field.
Codes
| Status | Name | When | Handling |
|---|---|---|---|
| 400 | Bad Request | The request body is invalid, or limit exceeds the tier maximum. | Send query and a limit within the tier's max-results cap. |
| 401 | Unauthorized | Missing, malformed or revoked API key. | Verify the Authorization header and key scope. |
| 402 | Payment Required | Your credits or balance are exhausted. | Top up in the Wallet and retry. |
| 404 | Not Found | The requested resource (e.g. result_id) does not exist. | Confirm the id was returned by a previous search. |
| 429 | Too Many Requests | Rate limit exceeded for your tier. | Honor Retry-After, then back off exponentially or upgrade. |
| 5xx | Service Error | Transient upstream failure. | Retry with exponential backoff. |
Rate limiting is documented separately in Rate Limits. Quota exhaustion surfaces as 402 — manage it in the Wallet.