---
title: "Listar/buscar clientes"
method: GET
path: "/clientes"
tags: ["catalogos"]
---

# Listar/buscar clientes

`GET /clientes`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/clientes`
- Auth: HTTP bearer

`q` busca en razón social, identificación y email.

## Query parameters

- `q` string
- `limit` integer

## Response `200`

Clientes

- Cliente[]
  - `id` string, uuid
  - `tipoIdentificacion` '04' | '05' | '06' | '07' | '08' | '09': 04=RUC, 05=cédula, 06=pasaporte, 07=consumidor final, 08=id. exterior, 09=placa
  - `identificacion` string
  - `razonSocial` string
  - `email` string, nullable
  - `telefono` string, nullable
  - `direccion` string, nullable
  - `placa` string, nullable
  - `bloqueadoAt` string, date-time, nullable: No nulo = ficha bloqueada por LOPDP: fuera de listados, prellenado, CSV y reenvíos (resolución SPDP-SPD-2025-0030-R).
  - `bloqueadoMotivo` string, nullable
  - `limiteCredito` number, nullable: Hasta cuánto se le fía, en dólares. Solo avisa; `null` lo quita
  - `diasCredito` integer, nullable: Días de crédito que la factura propone; `null`, al contado

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)