Listar tickets
Tickets
GET /v1/crm/tickets
List tickets with filters by pipeline, stage, owner, tag, channel, and creation date.
GET
Listar tickets
Returns a paginated list of tickets. Results cover the whole company, not just the project your token belongs to — see Tenancy is implicit.
All filters combine with AND. The comma-separated parameters (
stage_ids, tag_ids, categories, channel_ids) match any of the listed values.
Endpoint
Required scope
crm:tickets: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:tickets:read scope.
Operational notes
completedis a string, not a boolean. Send the literal"true"or"false"; omitting it returns open and closed tickets together.- Stage and tag ids are opaque. There is no public endpoint for listing pipelines and stages yet — read those ids from the portal, or capture them from outbound webhook payloads.
- To poll for changes, filter by
date_fromon a rolling window rather than paging the entire company on every run.
Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Query Parameters
Búsqueda libre sobre el ticket
Filtrar por pipeline
Ids de etapa separados por coma
Ids de tag separados por coma
Filtrar por chat user (contacto)
Filtrar por usuario asignado
Categorías separadas por coma
Ids de canal separados por coma
'true' devuelve sólo cerrados, 'false' sólo abiertos
Fecha de creación desde (YYYY-MM-DD)
Fecha de creación hasta (YYYY-MM-DD)
Required range:
1 <= x <= 200Required range:
x >= 0