Skip to navigation
Guides

Rate limits

Halo limits how often you can call the API. A request over a limit is refused with 429:

{
  "status": false,
  "message": "Too Many Attempts.",
  "status_code": 429
}
Applies toLimitCounted per
All API requests60 a minuteIP address
All partner endpoints120 a minuteAPI key
POST /api/identity/bvn/verify20 a minute and 2,000 a dayAPI key
POST /api/identity/nin/verify20 a minute and 2,000 a dayAPI key
GET /api/identity/nin/status/{reference}60 a minuteAPI key

Every limit that applies to a request is checked, so the lowest one is reached first. The BVN, NIN and NIN status limits apply on top of the general limits.

When you get a 429, wait before trying again. For money requests, a 429 means the request was not processed, so you can send it again with the same reference.