Fetch a customer

curl --request GET \
  --url https://api.paystack.com/v1/customers/{customerId} \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Customer fetched successfully",
  "code": "ok",
  "data": {
    "id": "cust_01HXYZABC1234567890ABCDEFG",
    "type": "individual",
    "name": "Alice Johnson",
    "email": "alice@example.com",
    "merchant_reference": "ref_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "country_code": "NG",
    "tier": "tier_0",
    "kyc_status": "not_started",
    "metadata": {
      "source": "checkout"
    },
    "created_at": "2026-04-16T16:14:08.000Z",
    "updated_at": "2026-04-16T16:14:08.000Z"
  },
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Customers

Fetch a customer

Returns a single customer scoped to the calling integration.

The path id is the GlobalStack external identifier (cust_…) returned by POST /v1/customers and GET /v1/customers.

Errors

400 invalid_input — customer_id does not start with cust_. This catches callers passing a non-GlobalStack id.
404 not_found — returned for all lookup misses:
- the id does not exist;
- the customer exists but belongs to a different integration;
These cases share a single 404 response so a caller cannot distinguish “doesn’t exist” from “belongs to someone else”.

Example

GET /v1/customers/cust_01HXYZABC1234567890ABCDEFG

GET

customers

{customerId}

Fetch a customer

curl --request GET \
  --url https://api.paystack.com/v1/customers/{customerId} \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Customer fetched successfully",
  "code": "ok",
  "data": {
    "id": "cust_01HXYZABC1234567890ABCDEFG",
    "type": "individual",
    "name": "Alice Johnson",
    "email": "alice@example.com",
    "merchant_reference": "ref_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "country_code": "NG",
    "tier": "tier_0",
    "kyc_status": "not_started",
    "metadata": {
      "source": "checkout"
    },
    "created_at": "2026-04-16T16:14:08.000Z",
    "updated_at": "2026-04-16T16:14:08.000Z"
  },
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Authorizations

Authorization

string

header

required

API key issued during merchant onboarding.

Path Parameters

customerId

string

required

Pattern: [^\/#\?]+?

Response

Customer fetched successfully

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Customer fetched successfully"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object

required

Show child attributes