---
title: "Fetch Customer Details"
method: GET
path: "/v3/customer/{id}"
---

# Fetch Customer Details

`GET /v3/customer/{id}`

This endpoint fetches the details of an already existing customer

## Path parameters

- `id` string, required

## Response `200`

200

- object
  - `status` string — Indicates whether the request was successful.
  - `message` string — Describes the result or status of the operation.
  - `data` object — Contains all the details of the created customer.
    - `id` string — Unique identifier for the customer.
    - `object` string — Type of object returned, typically 'customer'.
    - `created_at` string — Timestamp when the customer record was created.
    - `name` string — Full name of the customer.
    - `email` string — Email address of the customer.
    - `country` string — Country code of the customer (ISO 3166-1 alpha-2 format).
    - `phone` Phone — Phone contact details
      - `calling_code` string — Calling country code (for example, '1' for United States, '91' for India)
      - `number` string — Phone Number
    - `billing_address` object[] — List of billing addresses associated with the customer.
      - `name` string — Name associated with the billing address.
      - `address` Address — Address details
        - `line1` string — Address Line 1
        - `line2` string — Address Line 2
        - `city` string — Address city
        - `state` string — Address state
        - `country` string — Address country (ISO 3166-1 alpha-2 country code)
        - `postal_code` string — Postal Code
      - `phone` Phone — Phone contact details
        - `calling_code` string — Calling country code (for example, '1' for United States, '91' for India)
        - `number` string — Phone Number
      - `label` string — Denotes the type of address (Example - home, work).
    - `shipping_address` object[] — List of shipping addresses associated with the customer.
      - `name` string — Name associated with the shipping address.
      - `address` Address — Address details
        - `line1` string — Address Line 1
        - `line2` string — Address Line 2
        - `city` string — Address city
        - `state` string — Address state
        - `country` string — Address country (ISO 3166-1 alpha-2 country code)
        - `postal_code` string — Postal Code
      - `phone` Phone — Phone contact details
        - `calling_code` string — Calling country code (for example, '1' for United States, '91' for India)
        - `number` string — Phone Number
      - `label` string — Denotes the type of address (Example - home, work).
    - `metadata` Metadata, nullable — Custom metadata key-value pairs attached to the object
  - `reference_id` string — Reference id attached to a customer.
  - `risk_rule` string

---

[API](https://skmtc.net/tazapay/apis/sandbox.md) · [All operations](https://skmtc.net/tazapay/apis/sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tazapay/sandbox/versions/bf5f4b8f6f5d/schema)