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

idstring · nullableOptional

full_namestring · nullableOptional

Customer's full name (OPTIONAL)

emailstring · nullableOptional

Customer's email (REQUIRED)

phone_numberstring · nullableOptional

Customer's phone number (OPTIONAL)

addressstring · nullableOptional

Customer's address (OPTIONAL)

statusstring · enumOptionalPossible values:

created_atstring · date-timeOptional

Timestamp when the customer was created.

edited_atstring · date-time · nullableOptional

Timestamp when the customer was last updated.

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
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "full_name": "text",
  "email": "text",
  "phone_number": "text",
  "address": "text",
  "status": "active",
  "created_at": "2026-03-20T18:32:00.907Z",
  "edited_at": "2026-03-20T18:32:00.907Z",
  "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": "2026-03-20T18:32:00.907Z",
      "edited_at": "2026-03-20T18:32:00.907Z",
      "customer_id": "text",
      "payout_tag": "text",
      "payout_tag_description": "text",
      "payout_tag_metadata": "text"
    }
  ]
}