API reference · Identity & onboarding

Nationalities

GET/accountholder/{type}/{value}/nationalitiesList an account holder's nationalities
POST/accountholder/{type}/{value}/nationalityRecord a nationality for an account holder
GET/nationality/{id}Fetch one nationality
PUT/nationality/{id}Update one nationality

GET List an account holder's nationalities

GET /accountholder/{type}/{value}/nationalities

Headers

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

Path parameters

Name
`type`
`value`

Example

Response: GenericResponseListNationalityResponse

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

{
  "data": [
    {
      "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "countryCode": "NG",
      "acquisitionType": "BIRTH",
      "primaryNationality": "true",
      "evidenceDocumentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "assuranceGrade": "REG",
      "verificationStatus": "VERIFIED",
      "verificationMethod": "string",
      "verifierName": "NIMC",
      "verificationDateTime": "2026-09-25T10:00:00Z",
      "expiryDateTime": "2026-09-25T10:00:00Z",
      "disputeStatus": "NONE"
    }
  ],
  "description": "Nationalities fetched successfully"
}

Responses

Status	When
`200`	Nationalities fetched successfully

POST Record a nationality for an account holder

POST /accountholder/{type}/{value}/nationality

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Content-Type`	application/json

Path parameters

Name
`type`
`value`

Example

Request body: NationalityRequest · Response: GenericResponseNationalityResponse

curl -X POST "https://api.bridgemoni.com/accountholder/value/value/nationality" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "countryCode": "NG",
  "acquisitionType": "BIRTH",
  "primaryNationality": "true",
  "evidenceDocumentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}'

{
  "countryCode": "NG",
  "acquisitionType": "BIRTH",
  "primaryNationality": "true",
  "evidenceDocumentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "countryCode": "NG",
    "acquisitionType": "BIRTH",
    "primaryNationality": "true",
    "evidenceDocumentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "assuranceGrade": "REG",
    "verificationStatus": "VERIFIED",
    "verificationMethod": "string",
    "verifierName": "NIMC",
    "verificationDateTime": "2026-09-25T10:00:00Z",
    "expiryDateTime": "2026-09-25T10:00:00Z",
    "disputeStatus": "NONE"
  },
  "description": "Nationalities created successfully"
}

Responses

Status	When
`200`	Nationalities created successfully

GET Fetch one nationality

GET /nationality/{id}

Headers

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

Path parameters

Name
`id`

Example

Response: GenericResponseNationalityResponse

curl -X GET "https://api.bridgemoni.com/nationality/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",
    "countryCode": "NG",
    "acquisitionType": "BIRTH",
    "primaryNationality": "true",
    "evidenceDocumentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "assuranceGrade": "REG",
    "verificationStatus": "VERIFIED",
    "verificationMethod": "string",
    "verifierName": "NIMC",
    "verificationDateTime": "2026-09-25T10:00:00Z",
    "expiryDateTime": "2026-09-25T10:00:00Z",
    "disputeStatus": "NONE"
  },
  "description": "Nationalities fetched successfully"
}

Responses

Status	When
`200`	Nationalities fetched successfully

PUT Update one nationality

PUT /nationality/{id}

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Content-Type`	application/json

Path parameters

Name
`id`

Example

Request body: UpdateNationalityRequest · Response: GenericResponseNationalityResponse

curl -X PUT "https://api.bridgemoni.com/nationality/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "countryCode": "NG",
  "acquisitionType": "BIRTH",
  "primaryNationality": "true",
  "evidenceDocumentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}'

{
  "countryCode": "NG",
  "acquisitionType": "BIRTH",
  "primaryNationality": "true",
  "evidenceDocumentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "countryCode": "NG",
    "acquisitionType": "BIRTH",
    "primaryNationality": "true",
    "evidenceDocumentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "assuranceGrade": "REG",
    "verificationStatus": "VERIFIED",
    "verificationMethod": "string",
    "verifierName": "NIMC",
    "verificationDateTime": "2026-09-25T10:00:00Z",
    "expiryDateTime": "2026-09-25T10:00:00Z",
    "disputeStatus": "NONE"
  },
  "description": "Nationalities updated successfully"
}

Responses

Status	When
`200`	Nationalities updated successfully

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