Fetch Customer

Retrieves a Customer's details

Retrieves a customer with the specified id.

get

Authorizations

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

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-07-02T00:01:10.696Z",
  "edited_at": "2025-07-02T00:01:10.696Z",
  "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-07-02T00:01:10.696Z",
      "edited_at": "2025-07-02T00:01:10.696Z",
      "customer_id": "text",
      "payout_tag": "text",
      "payout_tag_description": "text",
      "payout_tag_metadata": "text"
    }
  ]
}