Skip to main content
GET
/
customers
/
{id}
Get a customer
curl --request GET \
  --url https://api.corebill.io/v1/customers/{id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "cus_a1b2c3d4e5f6",
    "name": "John Doe",
    "slug": "john-doe",
    "contact_email": "[email protected]",
    "contact_phone": "+1-555-0100",
    "country": "US",
    "city": "San Francisco",
    "currency": "USD",
    "status": "active",
    "legal_name": "John Doe LLC",
    "legal_address": "123 Market St, San Francisco, CA 94105",
    "legal_vat": "US123456789",
    "zipcode": "94105",
    "notes": "Preferred payment method: wire transfer",
    "created_at": "2025-03-01T09:00:00.000Z",
    "updated_at": "2025-03-15T11:30:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Generate keys from the Corebill dashboard under the Developers section.

Example: Authorization: Bearer sk_live_abc123def456

Path Parameters

​
id
string
required

The customer ID

Query Parameters

​
company_id
string
required

The company ID to scope the request to

Response

Customer details

​
data
object
required

Full customer object including notes (returned by GET /customers/{id})