Listar clientes
Por páginas; los clientes archivados solo con include_archived=true.
Scope necesario: customers:read.
Scope: customers:read
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| limit(query) | integer | no | Por defecto: 50 · mín. 1 · máx. 100 |
| offset(query) | integer | no | Por defecto: 0 · mín. 0 |
| include_archived(query) | "true" | "false" | no | Por defecto: "false" |
Respuestas
- 200 Lista de clientes.
- 400 Entrada no válida.
- 401 Falta la clave API, es desconocida o está revocada. Cuerpo vacío.
- 403 A la clave le falta el scope necesario.
- 429 Demasiadas peticiones para esta clave.
- 500 Error interno.
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| data | object[] | sí | |
| data[].id | string (uuid) | sí | |
| data[].customer_number | string | null | sí | |
| data[].customer_type | "company" | "private" | sí | |
| data[].salutation | "herr" | "frau" | null | sí | |
| data[].company_name | string | null | sí | |
| data[].first_name | string | null | sí | |
| data[].last_name | string | null | sí | |
| data[].display_name | string | sí | |
| data[].email | string | null | sí | |
| data[].phone | string | null | sí | |
| data[].mobile_phone | string | null | sí | |
| data[].fax | string | null | sí | |
| data[].address_street | string | null | sí | |
| data[].address_zip | string | null | sí | |
| data[].address_city | string | null | sí | |
| data[].tax_id | string | null | sí | |
| data[].notes | string | null | sí | |
| data[].is_archived | boolean | sí | |
| data[].created_at | string | sí | |
| data[].updated_at | string | null | sí | |
| pagination | object | sí | |
| pagination.limit | integer | sí | |
| pagination.offset | integer | sí | |
| pagination.total | integer | sí |