Fetch Customer

Retrieves a Customer's details

Retrieves a customer with the specified id.

get

/v1/customers/{id}

Authorizations

Path parameters

idstringrequired

The id of the entry to retrieve

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/customers/{id}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

401

404

200

{
  "id": "text",
  "full_name": "text",
  "email": "text",
  "phone_number": "text",
  "address": "text",
  "status": "active",
  "created_at": "2025-02-20T19:25:16.659Z",
  "edited_at": "2025-02-20T19:25:16.659Z",
  "dedicated_virtual_accounts": [
    {
      "id": "text",
      "is_live": true,
      "account_reference": "text",
      "gateway_code": "text",
      "callback_url": "text",
      "account_name": "text",
      "account_number": "text",
      "country": "text",
      "bank_code": "text",
      "bank_name": "text",
      "currency": "text",
      "bvn": "text",
      "metadata": "text",
      "created_at": "2025-02-20T19:25:16.659Z",
      "edited_at": "2025-02-20T19:25:16.659Z",
      "customer_id": "text",
      "payout_tag": "text",
      "payout_tag_description": "text",
      "payout_tag_metadata": "text"
    }
  ]
}

Returns 200 and the requested customer