Fetch Customer

Retrieves a Customer's details

Retrieves a customer with the specified id.

get

Authorizations

Bearer

AuthorizationstringRequired

API Key as Bearer Token

Path parameters

idstringRequired

The id of the entry to retrieve

Responses

200

Returns 200 and the requested customer

application/json

400

Returns 400 if the query is invalid

401

Returns 401 when authorization details is invalid

404

Returns 404 if a customer with the specified id is not found

get

/v1/customers/{id}

HTTPcURLJavaScriptPython

GET /v1/customers/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "full_name": "text",
  "email": "text",
  "phone_number": "text",
  "address": "text",
  "status": "active",
  "created_at": "2025-12-14T11:46:38.090Z",
  "edited_at": "2025-12-14T11:46:38.090Z",
  "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-12-14T11:46:38.090Z",
      "edited_at": "2025-12-14T11:46:38.090Z",
      "customer_id": "text",
      "payout_tag": "text",
      "payout_tag_description": "text",
      "payout_tag_metadata": "text"
    }
  ]
}