Error Codes
All error responses use the standard envelope with error, code, and status fields.
| Code | HTTP Status | Meaning |
|---|---|---|
| INVALID_COUNTRY | 400 | Country code is not supported. Use GH, NG, KE, ZA, or RW. |
| INVALID_COUNT | 400 | Count is out of range. Must be between 1 and 100. |
| RATE_LIMITED | 429 | Too many requests. Slow down or use an API key for higher limits. |
| INVALID_API_KEY | 401 | API key is missing or invalid. |
| DATASET_REQUIRES_KEY | 403 | The /v1/dataset endpoint requires a valid API key. |
| INTERNAL_ERROR | 500 | Something went wrong on the server. Please try again. |