Referencia

Referencia: Customers (clientes)

Los clientes de tu organización: hoteles, agencias, apartamentos, empresas y el motor público. Solo lectura.

GET/v1/customers

customers:read

Lista paginada de clientes no borrados, de más reciente a más antiguo.

Parámetro	Dónde	Tipo	Descripción
`active`	query	`true \| false`	Solo activos o solo inactivos. Ausente: todos.
`limit`	query	`integer`	1–100, por defecto 25.
`cursor`	query	`string`	El next_cursor anterior.

Petición

curl

curl "https://wearetransfers.com/api/v1/customers?active=true" \
  -H "Authorization: Bearer $WAT_API_KEY"

Respuesta

json

{
  "data": [
    {
      "id": "7e6d5c4b-3a2b-4c1d-9e8f-7a6b5c4d3e2f",
      "external_id": "CLI-0042",
      "name": "Hotel Las Arenas",
      "type": "account",
      "active": true,
      "group": {
        "id": "2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f",
        "name": "Cadena Arenas"
      },
      "created_at": "2026-03-02T09:14:00.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

GET/v1/customers/{id}

customers:read

Un cliente por UUID. Ajeno o borrado: 404.

Parámetro	Dónde	Tipo	Descripción
`id *`	path	`uuid`	Id del cliente.

Petición

curl

curl https://wearetransfers.com/api/v1/customers/7e6d5c4b-3a2b-4c1d-9e8f-7a6b5c4d3e2f \
  -H "Authorization: Bearer $WAT_API_KEY"

Respuesta

json

{
  "id": "7e6d5c4b-3a2b-4c1d-9e8f-7a6b5c4d3e2f",
  "external_id": "CLI-0042",
  "name": "Hotel Las Arenas",
  "type": "account",
  "active": true,
  "group": {
    "id": "2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f",
    "name": "Cadena Arenas"
  },
  "created_at": "2026-03-02T09:14:00.000Z"
}

El objeto Customer

Campo	Tipo	Qué es
`id`	uuid	Identificador estable. Es el customer.id de las reservas y el customer_id del filtro.
`external_id`	string \| null	Tu id para este cliente, si lo guardaste.
`name`	string \| null	Nombre.
`type`	account \| public_engine	Cliente con cuenta (hotel, agencia…) o el motor público de la empresa.
`active`	boolean	Si puede reservar.
`group`	object \| null	id y name del grupo (cadena hotelera, agrupación).
`created_at`	date-time	Alta.

Los datos de facturación del cliente (razón social, NIF, dirección) están previstos bajo billing:read y no forman parte de v1.