---
title: "Obtener Customer"
method: GET
path: "/customers/{encrypted_customer_id}"
tags: ["Customers"]
---

# Obtener Customer

`GET /customers/{encrypted_customer_id}`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/customers/{encrypted_customer_id}`
- Auth: API key in header `x-api-key`

Devuelve un Customer a partir de su identificador público.

Entrega todos los datos del Customer registrados en la organización. Responde `404` si el Customer no existe o no pertenece a la organización autenticada.

**Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Path parameters

- `encrypted_customer_id` string, required: Identificador público del Customer (`cus_...`).

## Headers

- `x-account-key` string: Llave de API de una Account, para operar sobre esa Account en lugar de la principal.
- `x-api-version` string, date: Versión del API para esta petición, como cualquier fecha `YYYY-MM-DD`. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización.

## Response `200`

Successful Response

- Customer: Cliente de la organización: la persona o empresa a la que se le cobra. Es el punto de partida de la integración: las Subscriptions y las Invoices se crean siempre asociadas a un Customer, y los medios de pago quedan guardados a su nombre. Para referenciarlo sirve tanto el identificador que Toku devuelve al crearlo como el `external_id` con el que lo conoce la organización integrada.
  - `agent_phone_number` string: Número de teléfono del agente por defecto.
  - `default_agent` string: Correo del agente por defecto que contactará al cliente cuando se abra un ticket.
  - `default_receipt_type` 'bill' | 'invoice' | 'no_receipt': Documento tributario que se emite al cobrar: `bill` es una boleta, `invoice` una factura y `no_receipt` deja el cobro sin documento asociado.
  - `external_id` string: Identificador externo del cliente definido por la organización. Por defecto, las organizaciones usan el government_id como identificador externo del cliente.
  - `fiscal_regime` string: Régimen fiscal del cliente, requerido para generar el recibo CFDI (México).
  - `government_id` string: Identificador tributario o personal del cliente según su país. Por ejemplo, el RUT de una persona en Chile: 18.579.787-K.
  - `id` string, required: Identificador público del cliente.
  - `mail` string: Correo electrónico del cliente.
  - `metadata` object: Campos adicionales definidos por cada organización para el cliente.
  - `name` string: Nombre del cliente.
  - `pac_mandate_id` string: Identificador del mandato PAC (Pago Automático de Cuentas) asociado al cliente.
  - `phone_number` string: Número de teléfono del cliente.
  - `rfc` string: RFC del cliente (México); si está presente, la deuda generará el documento tributario correspondiente.
  - `secondary_emails` string[]: Lista de correos electrónicos secundarios del cliente.
  - `send_mail` boolean: Determina si se debe emitir el webhook 'invoice.no_payment_method' al crear el cliente.
  - `silenced_until` string, date-time: Fecha y hora en que expira el silenciamiento del cliente. Si es null, el cliente no está silenciado.
  - `tax_zip_code` string: Código postal tributario del cliente, requerido para generar el recibo CFDI (México).

## Other responses

- `401`: Falta de credenciales.
- `403`: Falta de permisos. No tienes por qué estar ahi 👀.
- `404`: El recurso no fue encontrado.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Superaste el número máximos de request permitidos, espera un poquito.

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)