Skip to main content
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 the crm:tickets:read scope.

Operational notes

  • completed is 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_from on a rolling window rather than paging the entire company on every run.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Query Parameters

keyword
string

Búsqueda libre sobre el ticket

pipeline_id
string

Filtrar por pipeline

stage_ids
string

Ids de etapa separados por coma

tag_ids
string

Ids de tag separados por coma

chat_user_id
string

Filtrar por chat user (contacto)

assigned_to
string

Filtrar por usuario asignado

categories
string

Categorías separadas por coma

channel_ids
string

Ids de canal separados por coma

completed
string

'true' devuelve sólo cerrados, 'false' sólo abiertos

date_from
string

Fecha de creación desde (YYYY-MM-DD)

date_to
string

Fecha de creación hasta (YYYY-MM-DD)

limit
number
default:50
Required range: 1 <= x <= 200
offset
number
default:0
Required range: x >= 0

Response

200 - application/json
data
object[]
required
total
number
required
limit
number
required
offset
number
required