> ## Documentation Index
> Fetch the complete documentation index at: https://developers.tesoria.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# El contacto

> Proveedores, clientes y demás contrapartes (`contacts`).

Las personas y empresas con las que tu empresa tiene movimientos: proveedores, clientes, acreedores.

## Endpoints

| | |
| - | - |
| [`GET /contacts`](/contactos/listar) | Lista tus contactos. |
| [`GET /contacts/{id}`](/contactos/obtener) | Un contacto. |

Permiso necesario: `contacts:read`. Si tu sistema manda contactos a Tesoria, `external_id` es **tu** id y puedes buscar con él.

## Campos

| Campo | Tipo | Qué es |
| - | - | - |
| `id` | string | Id de Tesoria. |
| `name` | string | Nombre o razón social. |
| `rfc` | string \| null | RFC. |
| `external_id` | string \| null | Tu id del contacto, si entró desde tu sistema. |
| `emails` | lista | Correos del contacto. |
| `bank_account` | `{ clabe, bank_code, bank_name }` \| null | La cuenta a la que Tesoria le paga: su cuenta favorita con CLABE. |
| `created_at`, `updated_at` | fecha-hora | |

Filtros de la lista: `q` (nombre contiene), `rfc`, `external_id`, `updated_since`, `sort` (`name` o `updated_at`).

## Ejemplo

```json theme={null}
{
  "id": "66a01b2c3d4e5f0012ab0002",
  "name": "Estacionamientos del Centro SA de CV",
  "rfc": "ECE010101AB1",
  "external_id": "1234",
  "emails": ["pagos@ejemplo.com"],
  "bank_account": { "clabe": "012180000000000002", "bank_code": "40012", "bank_name": "BBVA MEXICO" },
  "created_at": "2026-05-10T21:24:55.476-06:00",
  "updated_at": "2026-09-28T11:02:10.000-06:00"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.