BridgeAPI reference · Accounts & ledger
External Accounts
POST Resolve the account-holder name behind an external account
POST /account/external/enquiry
Forwards accountNumber/providerCode/countryCode to the mediation service, which owns provider routing entirely - this endpoint never knows or picks a provider. The resolved name is cached permanently, shared across every tenant (not tenant-scoped); a request already answered before is served from that cache with no mediation-service call at all.
Headers
| Name | Notes |
|---|---|
Authorization | Bearer token |
X-Tenant | Your tenant |
X-Environment | test or live |
Content-Type | application/json |
Example
Request body: ExternalAccountEnquiryRequest · Response: ExternalAccountEnquiryResponse
curl -X POST "https://api.bridgemoni.com/account/external/enquiry" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" \
-H "Content-Type: application/json" \
-d '{
"accountNumber": "0123456789",
"providerCode": "provider code",
"countryCode": "NG"
}'{
"accountNumber": "0123456789",
"providerCode": "provider code",
"countryCode": "NG"
}{
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"accountNumber": "0123456789",
"providerCode": "provider code",
"countryCode": "NG",
"accountName": "Ada Obi"
},
"description": "Resolve the account-holder name behind an external account"
}Responses
| Status | When |
|---|---|
200 | Account enquiry resolved |
Generated from the OpenAPI document. Branch on the HTTP status: there is no machine-readable error code on the wire. Errors