---
title: "Retrieve Customer by External ID"
method: GET
path: "/customers"
---

# Retrieve Customer by External ID

`GET /customers`

## Query parameters

- `merchant_customer_id` string

## Response `200`

200

- object
  - `id` string
  - `merchant_customer_id` string
  - `first_name` string
  - `last_name` string
  - `gender` string
  - `date_of_birth` string
  - `email` string
  - `nationality` string
  - `country` string
  - `document` object
    - `document_type` string
    - `document_number` string
  - `phone` object
    - `number` string
    - `country_code` string
  - `billing_address` object
    - `address_line_1` string
    - `address_line_2` string
    - `country` string
    - `state` string
    - `city` string
    - `zip_code` string
    - `neighborhood` string
  - `shipping_address` object
    - `address_line_1` string
    - `address_line_2` string
    - `country` string
    - `state` string
    - `city` string
    - `zip_code` string
    - `neighborhood` string
  - `metadata` object[]
    - `key` string
    - `value` string
  - `created_at` string
  - `updated_at` string
  - `merchant_customer_created_at` string

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/versions/05b629819b49/schema)