API Reference · Customers

Retrieve a customer

Fetches a customer by id.

GET/v1/customers/:id

Returns the customer object, including Stripe linkage but excluding any internal secrets.

Returnscustomer object

Path parameters

idstringRequired

Customer id (`cus_…`).

Errors

404

resource_missing

No customer exists with that id.

Request

curl https://lunipay.io/api/v1/customers/cus_01JRZK2Q4T9ZS0VCNA3HX7W9EY \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "id": "cus_01JRZK2Q4T9ZS0VCNA3HX7W9EY",
  "object": "customer",
  "livemode": false,
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "phone": "+18765551234",
  "company_name": "Analytical Engines Ltd.",
  "notes": "VIP — priority support",
  "metadata": {
    "internal_id": "ACCT-42"
  },
  "stripe_customer_id": "cus_Pxxxxxxxxxxxx",
  "created": 1713100800,
  "updated": 1713100800
}