# Get customer details by External Key

Retrieves detailed information about a specific customer using their External Key.

Endpoint: GET /customers/{externalKey}
Version: 1.0

## Path parameters:

  - `externalKey` (string, required)
    External Key of the customer to retrieve details for
    Example: "cus_c93f7e842b89b9f7cad17918"

## Header parameters:

  - `cc-api-key` (string, required)
    Chaching API Key

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for the object.
    Example: "cus_NffrFeUfNV2Hib"

  - `object` (string, required)
    The type of the object.
    Example: "customer"

  - `name` (string, required)
    The full name or business name of the customer.
    Example: "John Doe"

  - `email` (string)
    The customer’s email address.
    Example: "john.doe@example.com"

  - `description` (string)
    An arbitrary string attached to the object. Often useful for displaying to users.
    Example: "My First Test Customer"

  - `phone` (string)
    The customer’s phone number.

  - `created` (number, required)
    Time at which the object was created. Measured in seconds since the Unix epoch.
    Example: 1680893993

  - `currency` (string)
    Three-letter ISO currency code
    Example: "USD"

  - `address` (array)
    The customer’s address.

  - `address.city` (string)
    City, district, suburb, town, or village.
    Example: "San Francisco"

  - `address.country` (string)
    Two-letter country code(ISO 3166 - 1 alpha - 2).
    Example: "US"

  - `address.line1` (string)
    Address line 1(e.g., street, PO Box, or company name).
    Example: "123 Market St"

  - `address.line2` (string)
    Address line 2(e.g., apartment, suite, unit, or building).
    Example: "Apt 4B"

  - `address.postal_code` (string)
    ZIP or postal code.
    Example: "94103"

  - `address.state` (string)
    State, county, province, or region.
    Example: "CA"

  - `shipping` (object)
    The customer’s shipping information. Appears on invoices emailed to this customer.

  - `shipping.name` (string, required)
    The name of the recipient.
    Example: "John Doe"

  - `shipping.phone` (string, required)
    The phone number of the recipient.
    Example: "+1 (555) 123-4567"

  - `shipping.address` (object, required)
    The address of the recipient.


## Response 404 fields