Get NRS States
GET
/{stage}/external/{businessId}/resources/states
Quick Reference
| Method | Endpoint | Authentication Required |
|---|---|---|
GET | {{baseUrl}}/{{stage}}/external/businesses/:businessId/resources/states | Yes |
Request Structure
Path Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
businessId | string | ✅ | Unique identifier of the business | 26ede24b-ac50-475f-aacc-5ea6339f0863 |
Headers
| Header | Value | Required |
|---|---|---|
Content-Type | application/json or */* | Yes |
Accept | application/json or */* | Yes |
X-Business-Key | businessKey | Yes |
Response Format
Success Response (200)
{
"responseCode": "00",
"responseMessage": "State resources retrieved successfully",
"data": [
{
"name": "Lagos",
"code": "LA"
},
{
"name": "Ogun",
"code": "OG"
},
{
"name": "Oyo",
"code": "OY"
},
{
"name": "Rivers",
"code": "RI"
}
]
}Response Data Structure
Currency Object
| Field | Type | Description |
|---|---|---|
code | string | ISO currency code (e.g., NGN, USD) |
decimalDigits | number | Number of decimal places for the currency |
name | string | Full currency name |
namePlural | string | Plural form of currency name |
rounding | number | Rounding increment (0 = no rounding) |
symbol | string | Currency symbol |
symbolNative | string | Native currency symbol representation |
Error Responses
| Error Code | Message | Description |
|---|---|---|
404 | Business not found | Business ID doesn't exist |
403 | Access denied | User doesn't have permission |
400 | Invalid business ID | Business ID format is invalid |
Example Error Response
{
"responseCode": "404",
"responseMessage": "Business not found with ID: invalid-business-id",
"data": null
}Related Endpoints
/invoices - Create invoice (uses currency data)/businesses/{businessId}/settings - Get business configurationRequest
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '/{{stage}}/external/{{businessId}}/resources/states' \
--header 'X-Business-Key: BK-26EDE24BAC50475FAACC5EA6339F0863-DEV-B2Z6QCEHI3X9' \
--header 'Accept: */*'Response Response Example
{
"responseCode": "00",
"responseMessage": "Completed successfully",
"data": [
{
"name": "Abia",
"code": "NG-AB"
},
{
"name": "Adamawa",
"code": "NG-AD"
},
{
"name": "Akwa Ibom",
"code": "NG-AK"
},
{
"name": "Anambra",
"code": "NG-AN"
},
{
"name": "Bauchi",
"code": "NG-BA"
},
{
"name": "Benue",
"code": "NG-BE"
},
{
"name": "Borno",
"code": "NG-BO"
},
{
"name": "Bayelsa",
"code": "NG-BY"
},
{
"name": "Cross River",
"code": "NG-CR"
},
{
"name": "Delta",
"code": "NG-DE"
},
{
"name": "Ebonyi",
"code": "NG-EB"
},
{
"name": "Edo",
"code": "NG-ED"
},
{
"name": "Ekiti",
"code": "NG-EK"
},
{
"name": "Enugu",
"code": "NG-EN"
},
{
"name": "Abuja Federal Capital Territory",
"code": "NG-FC"
},
{
"name": "Gombe",
"code": "NG-GO"
},
{
"name": "Imo",
"code": "NG-IM"
},
{
"name": "Jigawa",
"code": "NG-JI"
},
{
"name": "Kaduna",
"code": "NG-KD"
},
{
"name": "Kebbi",
"code": "NG-KE"
},
{
"name": "Kano",
"code": "NG-KN"
},
{
"name": "Kogi",
"code": "NG-KO"
},
{
"name": "Katsina",
"code": "NG-KT"
},
{
"name": "Kwara",
"code": "NG-KW"
},
{
"name": "Lagos",
"code": "NG-LA"
},
{
"name": "Nasarawa",
"code": "NG-NA"
},
{
"name": "Niger",
"code": "NG-NI"
},
{
"name": "Ogun",
"code": "NG-OG"
},
{
"name": "Ondo",
"code": "NG-ON"
},
{
"name": "Osun",
"code": "NG-OS"
},
{
"name": "Oyo",
"code": "NG-OY"
},
{
"name": "Plateau",
"code": "NG-PL"
},
{
"name": "Rivers",
"code": "NG-RI"
},
{
"name": "Sokoto",
"code": "NG-SO"
},
{
"name": "Taraba",
"code": "NG-TA"
},
{
"name": "Yobe",
"code": "NG-YO"
},
{
"name": "Zamfara",
"code": "NG-ZA"
}
]
}Modified at 2026-08-21 09:13:33