Skip to main content
403 ForbiddenAccount

ADDRESS_SEARCH_LIMIT_REACHED

The account has used its address searches

When it happens

An address search (/addresses/...) would pass the account's allowance: in Test mode, its test searches (50 to start); in Live mode, a monthly limit Reeds has set for the account. Nothing was looked up or counted. A search already under way (a session token already counted) still finishes.

How to fix it

  1. Send one session_token per typed address, the same on every call while your customer types it and on the GET /addresses/details that ends it, so each address counts once.
  2. In Test mode, email support@getreeds.co with your client id to raise the allowance.
  3. In Live mode, searches start again on the 1st of the next month, Lagos time. To change the limit, email support@getreeds.co.

Read more: Address search

RetryingFix the cause, then retry (with the same Idempotency-Key, if the request takes one).How idempotency works

Example response

HTTP 403 Forbidden
{
"status": "failed",
"error": {
"code": "ADDRESS_SEARCH_LIMIT_REACHED",
"message": "This account has used its 50 test address searches. Contact Reeds support for more.",
"doc_url": "https://developer.getreeds.co/errors/ADDRESS_SEARCH_LIMIT_REACHED"
}
}