API Documentation
CitySwift prices
CitySwift Request
FlexFlow Request
states
Get States
This endpoint retrieves a list of states.
Request Body
This request does not require a request body.
Response
-
status
(boolean): Indicates the status of the response. -
message
(string): Provides any additional information related to the response. -
data
(array): Contains an array of state objects.-
state_name
(string): The name of the state. -
state_code
(string): The code associated with the state. -
status
(string): The status of the state. -
label
(string): The label of the state. -
value
(number): The value associated with the state.
-
curl --request GET \
--url https://api.mervii.com/beta/utils/states \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"label": "Abia State",
"state_code": null,
"state_name": "Abia State",
"status": "Not Active",
"value": 1
},
{
"label": "Adamawa State",
"state_code": null,
"state_name": "Adamawa State",
"status": "Not Active",
"value": 2
},
{
"label": "Akwa Ibom State",
"state_code": null,
"state_name": "Akwa Ibom State",
"status": "Not Active",
"value": 3
},
{
"label": "Anambra State",
"state_code": null,
"state_name": "Anambra State",
"status": "Not Active",
"value": 4
},
{
"label": "Bauchi State",
"state_code": null,
"state_name": "Bauchi State",
"status": "Not Active",
"value": 5
},
{
"label": "Bayelsa State",
"state_code": null,
"state_name": "Bayelsa State",
"status": "Not Active",
"value": 6
},
{
"label": "Benue State",
"state_code": null,
"state_name": "Benue State",
"status": "Not Active",
"value": 7
},
{
"label": "Borno State",
"state_code": null,
"state_name": "Borno State",
"status": "Not Active",
"value": 8
},
{
"label": "Cross River State",
"state_code": null,
"state_name": "Cross River State",
"status": "Not Active",
"value": 9
},
{
"label": "Delta State",
"state_code": null,
"state_name": "Delta State",
"status": "Not Active",
"value": 10
},
{
"label": "Ebonyi State",
"state_code": null,
"state_name": "Ebonyi State",
"status": "Not Active",
"value": 11
},
{
"label": "Edo State",
"state_code": null,
"state_name": "Edo State",
"status": "Not Active",
"value": 12
},
{
"label": "Ekiti State",
"state_code": null,
"state_name": "Ekiti State",
"status": "Not Active",
"value": 13
},
{
"label": "Enugu State",
"state_code": null,
"state_name": "Enugu State",
"status": "Not Active",
"value": 14
},
{
"label": "FCT",
"state_code": null,
"state_name": "FCT",
"status": "Not Active",
"value": 15
},
{
"label": "Gombe State",
"state_code": null,
"state_name": "Gombe State",
"status": "Not Active",
"value": 16
},
{
"label": "Imo State",
"state_code": null,
"state_name": "Imo State",
"status": "Not Active",
"value": 17
},
{
"label": "Jigawa State",
"state_code": null,
"state_name": "Jigawa State",
"status": "Not Active",
"value": 18
},
{
"label": "Kaduna State",
"state_code": null,
"state_name": "Kaduna State",
"status": "Not Active",
"value": 19
},
{
"label": "Kano State",
"state_code": null,
"state_name": "Kano State",
"status": "Not Active",
"value": 20
},
{
"label": "Katsina State",
"state_code": null,
"state_name": "Katsina State",
"status": "Not Active",
"value": 21
},
{
"label": "Kebbi State",
"state_code": null,
"state_name": "Kebbi State",
"status": "Not Active",
"value": 22
},
{
"label": "Kogi State",
"state_code": null,
"state_name": "Kogi State",
"status": "Not Active",
"value": 23
},
{
"label": "Kwara State",
"state_code": null,
"state_name": "Kwara State",
"status": "Not Active",
"value": 24
},
{
"label": "Lagos State",
"state_code": null,
"state_name": "Lagos State",
"status": "Not Active",
"value": 25
},
{
"label": "Nasarawa State",
"state_code": null,
"state_name": "Nasarawa State",
"status": "Not Active",
"value": 26
},
{
"label": "Niger State",
"state_code": null,
"state_name": "Niger State",
"status": "Not Active",
"value": 27
},
{
"label": "Ogun State",
"state_code": null,
"state_name": "Ogun State",
"status": "Not Active",
"value": 28
},
{
"label": "Ondo State",
"state_code": null,
"state_name": "Ondo State",
"status": "Not Active",
"value": 29
},
{
"label": "Osun State",
"state_code": null,
"state_name": "Osun State",
"status": "Not Active",
"value": 30
},
{
"label": "Oyo State",
"state_code": null,
"state_name": "Oyo State",
"status": "Not Active",
"value": 31
},
{
"label": "Plateau State",
"state_code": null,
"state_name": "Plateau State",
"status": "Not Active",
"value": 32
},
{
"label": "Rivers State",
"state_code": null,
"state_name": "Rivers State",
"status": "Not Active",
"value": 33
},
{
"label": "Sokoto State",
"state_code": null,
"state_name": "Sokoto State",
"status": "Not Active",
"value": 34
},
{
"label": "Taraba State",
"state_code": null,
"state_name": "Taraba State",
"status": "Not Active",
"value": 35
},
{
"label": "Yobe State",
"state_code": null,
"state_name": "Yobe State",
"status": "Not Active",
"value": 36
},
{
"label": "Zamfara State",
"state_code": null,
"state_name": "Zamfara State",
"status": "Not Active",
"value": 37
}
],
"message": "Centres successfully fetched!",
"status": true
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Headers
"no-cache"
"<calculated when request is sent>"
"<calculated when request is sent>"
"PostmanRuntime/7.39.1"
"gzip, deflate, br"
"keep-alive"
Response
success
The response is of type object
.
curl --request GET \
--url https://api.mervii.com/beta/utils/states \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"label": "Abia State",
"state_code": null,
"state_name": "Abia State",
"status": "Not Active",
"value": 1
},
{
"label": "Adamawa State",
"state_code": null,
"state_name": "Adamawa State",
"status": "Not Active",
"value": 2
},
{
"label": "Akwa Ibom State",
"state_code": null,
"state_name": "Akwa Ibom State",
"status": "Not Active",
"value": 3
},
{
"label": "Anambra State",
"state_code": null,
"state_name": "Anambra State",
"status": "Not Active",
"value": 4
},
{
"label": "Bauchi State",
"state_code": null,
"state_name": "Bauchi State",
"status": "Not Active",
"value": 5
},
{
"label": "Bayelsa State",
"state_code": null,
"state_name": "Bayelsa State",
"status": "Not Active",
"value": 6
},
{
"label": "Benue State",
"state_code": null,
"state_name": "Benue State",
"status": "Not Active",
"value": 7
},
{
"label": "Borno State",
"state_code": null,
"state_name": "Borno State",
"status": "Not Active",
"value": 8
},
{
"label": "Cross River State",
"state_code": null,
"state_name": "Cross River State",
"status": "Not Active",
"value": 9
},
{
"label": "Delta State",
"state_code": null,
"state_name": "Delta State",
"status": "Not Active",
"value": 10
},
{
"label": "Ebonyi State",
"state_code": null,
"state_name": "Ebonyi State",
"status": "Not Active",
"value": 11
},
{
"label": "Edo State",
"state_code": null,
"state_name": "Edo State",
"status": "Not Active",
"value": 12
},
{
"label": "Ekiti State",
"state_code": null,
"state_name": "Ekiti State",
"status": "Not Active",
"value": 13
},
{
"label": "Enugu State",
"state_code": null,
"state_name": "Enugu State",
"status": "Not Active",
"value": 14
},
{
"label": "FCT",
"state_code": null,
"state_name": "FCT",
"status": "Not Active",
"value": 15
},
{
"label": "Gombe State",
"state_code": null,
"state_name": "Gombe State",
"status": "Not Active",
"value": 16
},
{
"label": "Imo State",
"state_code": null,
"state_name": "Imo State",
"status": "Not Active",
"value": 17
},
{
"label": "Jigawa State",
"state_code": null,
"state_name": "Jigawa State",
"status": "Not Active",
"value": 18
},
{
"label": "Kaduna State",
"state_code": null,
"state_name": "Kaduna State",
"status": "Not Active",
"value": 19
},
{
"label": "Kano State",
"state_code": null,
"state_name": "Kano State",
"status": "Not Active",
"value": 20
},
{
"label": "Katsina State",
"state_code": null,
"state_name": "Katsina State",
"status": "Not Active",
"value": 21
},
{
"label": "Kebbi State",
"state_code": null,
"state_name": "Kebbi State",
"status": "Not Active",
"value": 22
},
{
"label": "Kogi State",
"state_code": null,
"state_name": "Kogi State",
"status": "Not Active",
"value": 23
},
{
"label": "Kwara State",
"state_code": null,
"state_name": "Kwara State",
"status": "Not Active",
"value": 24
},
{
"label": "Lagos State",
"state_code": null,
"state_name": "Lagos State",
"status": "Not Active",
"value": 25
},
{
"label": "Nasarawa State",
"state_code": null,
"state_name": "Nasarawa State",
"status": "Not Active",
"value": 26
},
{
"label": "Niger State",
"state_code": null,
"state_name": "Niger State",
"status": "Not Active",
"value": 27
},
{
"label": "Ogun State",
"state_code": null,
"state_name": "Ogun State",
"status": "Not Active",
"value": 28
},
{
"label": "Ondo State",
"state_code": null,
"state_name": "Ondo State",
"status": "Not Active",
"value": 29
},
{
"label": "Osun State",
"state_code": null,
"state_name": "Osun State",
"status": "Not Active",
"value": 30
},
{
"label": "Oyo State",
"state_code": null,
"state_name": "Oyo State",
"status": "Not Active",
"value": 31
},
{
"label": "Plateau State",
"state_code": null,
"state_name": "Plateau State",
"status": "Not Active",
"value": 32
},
{
"label": "Rivers State",
"state_code": null,
"state_name": "Rivers State",
"status": "Not Active",
"value": 33
},
{
"label": "Sokoto State",
"state_code": null,
"state_name": "Sokoto State",
"status": "Not Active",
"value": 34
},
{
"label": "Taraba State",
"state_code": null,
"state_name": "Taraba State",
"status": "Not Active",
"value": 35
},
{
"label": "Yobe State",
"state_code": null,
"state_name": "Yobe State",
"status": "Not Active",
"value": 36
},
{
"label": "Zamfara State",
"state_code": null,
"state_name": "Zamfara State",
"status": "Not Active",
"value": 37
}
],
"message": "Centres successfully fetched!",
"status": true
}