Retrieve a customer

Get a customer with their payment count and totals.

Returns the customer with their totals. List their payments with GET /payments?customer_id=….

Path

id string Required

The customer's ID, such as cst_gWFWcc7Ga0Pv7LSC.

Errors

404 not_found

No customer with that ID belongs to your business.

Any request can also fail on its key or its body. See errors.

Request

curl "https://dash.402pay.co/api/v1/customers/cst_gWFWcc7Ga0Pv7LSC" \  -H "Authorization: Bearer $PAY402_SECRET_KEY"

Response200 OK

{  "data": {    "id": "cst_gWFWcc7Ga0Pv7LSC",    "kind": "customer",    "name": "Harper Wilson",    "email": "harper.wilson@example.com",    "blocked": false,    "note": "",    "stats": {      "payments_count": 2,      "incomplete_count": 2,      "volume": {        "amount": 22810,        "currency": "USD"      },      "average": {        "amount": 11405,        "currency": "USD"      },      "last_payment_at": "2026-09-26T21:22:47.082Z",      "preferred_rail": "crypto"    },    "created_at": "2026-09-26T21:01:16.809Z",    "updated_at": "2026-09-26T21:01:16.809Z"  }}