---
title: "Obter cliente"
method: GET
path: "/v1/customers/{id}"
tags: ["Clientes"]
---

# Obter cliente

`GET /v1/customers/{id}`

Retorna os dados completos de um cliente especifico.

## Path parameters

- `id` string, uuid, required

## Response `200`

Dados do cliente

- GetCustomerResponse
  - `data` CustomerData, nullable
    - `id` string, uuid — ID unico do cliente
    - `externalId` string, nullable — ID externo informado
    - `name` string — Nome do cliente
    - `email` string — E-mail do cliente
    - `document` string, nullable — CPF/CNPJ formatado
    - `documentType` 'CPF' | 'CNPJ', nullable — Tipo do documento
    - `phone` string, nullable — Telefone com codigo do pais, salvo apenas com digitos
    - `status` 'Active' | 'Inactive' — Status do cliente
    - `metadata` string, nullable — Metadados
    - `address` CustomerAddress, nullable
      - `street` string, nullable
      - `number` string, nullable
      - `complement` string, nullable
      - `neighborhood` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postalCode` string, nullable
      - `country` string, nullable
    - `createdAt` string, date-time — Data de criacao
  - `message` string, nullable
  - `error` ApiErrorResponse, nullable
    - `message` string — Mensagem de erro
    - `code` string — Codigo do erro

## Other responses

- `401` — Nao autorizado
- `404` — Cliente nao encontrado

---

[API](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway.md) · [All operations](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safefy-pay/safefy-pix-gateway/revisions/57157be53ccc/schema)