Listar eventos

Versión de la API 2026-10-affable-towhee

get https://api.getlingara.com/v1/events

Devuelve los eventos que tu cliente puede ver, una página cada vez, los más antiguos primero. Envía next_cursor como cursor para continuar.

Ámbitos events:read

Parámetros

Lingara-Versionheaderstringopcional: La versión de la API con la que se responde a esta solicitud. Sin ella, un token de acceso recibe la versión a la que está vinculado su cliente, y una solicitud sin token recibe la versión actual. La versión aún en desarrollo solo se alcanza nombrándola aquí. Una versión desconocida responde 400 con el código api_version_unknown. GET /v1/versions enumera las versiones.
cursorquerystringopcional: Desde dónde continuar: el next_cursor de una página anterior o el id: de un evento del flujo. Un cursor de más de 30 días responde 410 con el código cursor_expired.
startquerystringopcional: Dónde empezar sin cursor: latest para los eventos a partir de ahora, u oldest para todos los eventos que aún se conservan.
typesqueryarray of stringopcional: Solo estos tipos de evento, separados por comas. Sin él, todos los tipos que los ámbitos de tu token pueden leer.
limitqueryintegeropcional: El máximo de eventos que devuelve una página, de 1 a 100.

200 Una página de eventos y el cursor desde el que continuar

itemsarray of EventEnvelopeobligatorio

next_cursorstringobligatorio

has_morebooleanobligatorio

410application/json: api_version_discontinued: la versión de la API de esta solicitud se ha retirado. cursor_expired: el cursor tiene más de 30 días; vuelve a empezar sin él.
4XXapplication/json: La solicitud fue rechazada. code indica el motivo y error lo explica con palabras.
503application/json · text/plain: El servicio no está disponible temporalmente; vuelve a intentarlo tras el número de segundos indicado en Retry-After. Durante el mantenimiento, el cuerpo es texto sin formato en lugar del sobre de error.
5XXapplication/json: La solicitud fue rechazada. code indica el motivo y error lo explica con palabras.

codestringobligatorio: Por qué se rechazó la solicitud, como un código estable con el que ramificar: por ejemplo insufficient_scope (403), rate_limited (429) y, para un cliente con facturación por uso, spend_cap_reached (402) y metered_billing_inactive (402).
errorstringobligatorio

curl "https://api.getlingara.com/v1/events" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

Si una traducción y la referencia en inglés difieren, prevalece la referencia en inglés.