API reference · Identity & onboarding
Districts
GET Fetch a district by code, scoped to a parent
GET /district/code/{code}
Headers
| Name | Notes |
|---|
Authorization | Bearer token |
X-Tenant | Your tenant |
X-Environment | test or live |
Path parameters
Query parameters
| Name | Default |
|---|
parentReference | Optional |
Example
Response: DistrictResponse
curl -X GET "https://api.bridgemoni.com/district/code/BRG-001?parentReference=value" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV"
{
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"name": "Ada Obi",
"code": "district code",
"parentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"parentLevel": "COUNTRY",
"creationDateTime": "2027-03-14T14:30:01"
},
"description": "Fetch a district by code, scoped to a parent"
}
Responses
| Status | When |
|---|
200 | District fetched successfully |
404 | No district exists for the given code under this parent |
GET Fetch a district by reference
GET /district/{id}
Headers
| Name | Notes |
|---|
Authorization | Bearer token |
X-Tenant | Your tenant |
X-Environment | test or live |
Path parameters
Example
Response: DistrictResponse
curl -X GET "https://api.bridgemoni.com/district/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV"
{
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"name": "Ada Obi",
"code": "district code",
"parentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"parentLevel": "COUNTRY",
"creationDateTime": "2027-03-14T14:30:01"
},
"description": "Fetch a district by reference"
}
Responses
| Status | When |
|---|
200 | District fetched successfully |
404 | No district exists for the given reference |
GET List districts under a parent
GET /districts
Headers
| Name | Notes |
|---|
Authorization | Bearer token |
X-Tenant | Your tenant |
X-Environment | test or live |
Query parameters
| Name | Default |
|---|
parentReference | Optional |
Example
Response: List<DistrictResponse>
curl -X GET "https://api.bridgemoni.com/districts?parentReference=value" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV"
{
"data": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"name": "Ada Obi",
"code": "district code",
"parentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"parentLevel": "COUNTRY",
"creationDateTime": "2027-03-14T14:30:01"
}
],
"description": "List districts under a parent"
}
Responses
| Status | When |
|---|
200 | Districts fetched successfully |
Bridge