Get Merchant Customers

POST

/api/v{{apiVersion}}/business/card/customers

DTO: MerchantCustomerRequestDto — currently empty object {}.

Response: ApiResponse<GetMerchantCustomerResponse>.

Important: Sign {} exactly (no spaces) if your server is strict about byte-for-byte JSON; adjust if your client emits different whitespace.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://api-dev.usenumero.com/numeroaccount/api/v{{apiVersion}}/business/card/customers' \
--header '{{headerApiKeyName}}: {{businessApiKey}}' \
--header '{{headerSignatureName}}: {{requestSignature}}' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Response Example

{
  "status": true,
  "message": "Success",
  "code": "00",
  "version": "v1",
  "reference": "N2026032512010006",
  "data": {
    "merchantCustomers": [
      {
        "cardCustomerId": "cust_7a8b9c0d1e",
        "firstName": "Jane",
        "lastName": "Doe",
        "address1": "10 Broad Street",
        "address2": "Suite 2",
        "city": "Lagos",
        "state": "LA",
        "zipCode": "101241",
        "countryCode": "NG",
        "idNumber": "A12345678",
        "idType": "PASSPORT",
        "bvn": "22222222222",
        "cardIds": ["card_mid_abc123", "card_mid_def456"]
      }
    ]
  },
  "error": null
}

Modified at 2026-03-25 19:02:24

Get Card Transactions

Get Card Details