Listar clientes
Customers
GET /v1/crm/customers
List the customers of your company, with free-text search and phone lookup.
GET
Listar clientes
Returns a paginated list of customers. Results cover the whole company, not just the project your token belongs to — see Tenancy is implicit.
Endpoint
Required scope
crm:customers:read
Headers
Query parameters
Example request
Response
200 OK
400 Bad Request
limit above 200, negative offset, or an unknown query parameter.
401 Unauthorized
Missing, invalid, revoked, or expired token.403 Forbidden
The token does not have thecrm:customers:read scope.
Operational notes
- Search is a contains match, not fuzzy.
perezmatchesPérezandPerezoso; it does not match a typo likeperes. phoneis exact, including the+and country code. Store phones in E.164 if you plan to look them up.- To page through the full set, increment
offsetbylimituntiloffset >= total.
Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Query Parameters
Búsqueda libre por nombre o email
Filtrar por teléfono exacto
Required range:
1 <= x <= 200Required range:
x >= 0