rate_limited

Response

Every failure uses this envelope. credits_charged is 0. The message below is the default text for this code. Live messages can change, so branch on error.code.

1{2  "ok": false,3  "error": {4    "code": "rate_limited",5    "message": "Free accounts only: requests are arriving faster than the free limit; wait for Retry-After.",6    "retryable": true7  },8  "credits_charged": 0,9  "request_id": "req_0123456789abcdef01234567"10}

HTTP 429 responses for this code include a retry-after header: seconds to wait.

When it happens

• A free account sent requests faster than its limit. Packs and plans have no rate limits.

What to do

• Wait the number of seconds in the retry-after response header, then send the request again. Buying a pack or starting a plan removes the limit. See rate limits.
• This code is retryable, and the failed attempt costs nothing.

The response header x-request-id matches request_id. The full list is on errors.