API reference · Identity & onboarding

Countries

GET/countriesList all countries
GET/country/code/{code}Fetch a country by its ISO code
GET/country/{id}Fetch a country by reference

GET List all countries

GET /countries

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Example

Response: List<CountryResponse>

curl -X GET "https://api.bridgemoni.com/countries" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": [
    {
      "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "name": "country name",
      "code": "NG",
      "diallingCode": "dialling code",
      "flagUrl": "flag url",
      "creationDateTime": "2027-03-14T14:30:01"
    }
  ],
  "description": "List all countries"
}

Responses

Status	When
`200`	Countries fetched successfully

GET Fetch a country by its ISO code

GET /country/code/{code}

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`code`

Example

Response: CountryResponse

curl -X GET "https://api.bridgemoni.com/country/code/BRG-001" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "name": "country name",
    "code": "NG",
    "diallingCode": "dialling code",
    "flagUrl": "flag url",
    "creationDateTime": "2027-03-14T14:30:01"
  },
  "description": "Fetch a country by its ISO code"
}

Responses

Status	When
`200`	Country fetched successfully
`404`	No country exists for the given code

GET Fetch a country by reference

GET /country/{id}

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`id`

Example

Response: CountryResponse

curl -X GET "https://api.bridgemoni.com/country/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": "country name",
    "code": "NG",
    "diallingCode": "dialling code",
    "flagUrl": "flag url",
    "creationDateTime": "2027-03-14T14:30:01"
  },
  "description": "Fetch a country by reference"
}

Responses

Status	When
`200`	Country fetched successfully
`404`	No country exists for the given reference

Generated from the OpenAPI document. Branch on the HTTP status: there is no machine-readable error code on the wire. Errors