Saltar al contenido principal
GET
curl
Consulta Consultar eventos anteriores en la guía de ingesta de eventos. Para buscar entre varios sujetos, usa Listar eventos de monitorización.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

vendor_data
string
requerido

Tu ID para el sujeto (subject.vendor_data de sus eventos). Codifícalo para URL; un valor que contenga / no se puede usar con este endpoint.

Required string length: 1 - 255

Parámetros de consulta

entity_type
enum<string>
predeterminado:individual

company devuelve la empresa con este vendor_data; cualquier otro valor, o ninguno, devuelve la persona física. Se acepta subject_entity_type como alias cuando falta entity_type.

Opciones disponibles:
individual,
company
limit
integer
predeterminado:50

Número máximo de eventos por página. El valor predeterminado es 50. Los valores superiores a 1000000 devuelven 400; un valor no numérico, cero o negativo se sustituye por 50.

Rango requerido: 1 <= x <= 1000000
offset
integer
predeterminado:0

Número de eventos que se omiten. El valor predeterminado es 0. Es preferible seguir la URL next de la respuesta.

Rango requerido: 0 <= x <= 1000000
event_category
enum<string>[]

Solo eventos de estas categorías. Repite el parámetro para indicar varios valores (?event_category=payment&event_category=dispute); se devuelve cualquier evento que coincida con alguno de ellos.

Opciones disponibles:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
action_type
string[]

Solo eventos con estos tipos de acción (coincidencia exacta, distingue mayúsculas y minúsculas). Repite el parámetro para indicar varios valores.

status
enum<string>[]

Solo eventos con estos estados. Repite el parámetro para indicar varios valores.

Opciones disponibles:
ACCEPTED,
APPROVED,
IN_REVIEW,
DECLINED
retention_class
enum<string>[]

Solo eventos de estas clases de retención. Repite el parámetro para indicar varios valores.

Opciones disponibles:
low_value,
standard,
risk_relevant,
monetary_or_compliance
business_vendor_data
string

Coincidencia exacta con el business.vendor_data enviado con el evento.

session_id
string

Coincidencia exacta con session.session_id.

device_fingerprint
string

Coincidencia exacta con device_context.fingerprint.

ip_address
string

Coincidencia exacta con la dirección IP del evento.

game_id
string

Coincidencia exacta con el game_id promovido.

round_id
string

Coincidencia exacta con el round_id promovido.

affiliate_code
string

Coincidencia exacta con el affiliate_code promovido.

payment_reference_id
string

Coincidencia exacta con la referencia de pago (de transaction_context.payment_reference_id o payload.payment_reference_id).

counterparty_vendor_data
string

Coincidencia exacta con el counterparty_vendor_data promovido.

matched_only
boolean
predeterminado:false

true (también 1 o yes, sin distinguir mayúsculas de minúsculas) devuelve solo los eventos en los que coincidió al menos una regla (rules_matched_count mayor que 0). Cualquier otro valor se ignora.

occurred_from
string<date-time>

Solo eventos con occurred_at igual o posterior a este instante (inclusive). Envía un valor ISO 8601: 2026-10-01T00:00:00Z, un desfase explícito con el + codificado en formato porcentual (2026-10-01T02:00:00%2B02:00; un + sin codificar se decodifica como un espacio y el valor deja de poder interpretarse) o solo una fecha (2026-10-01), que equivale a las 00:00:00 UTC de ese día. Un valor sin desfase se interpreta como UTC. No se aceptan valores en ningún otro formato.

occurred_to
string<date-time>

Solo eventos con occurred_at igual o anterior a este instante (inclusive). Una fecha sola equivale al inicio de ese día, por lo que occurred_to=2026-10-15 excluye el resto del 15 de octubre; envía 2026-10-15T23:59:59Z para incluirlo. Envía un valor ISO 8601: 2026-10-01T00:00:00Z, un desfase explícito con el + codificado en formato porcentual (2026-10-01T02:00:00%2B02:00; un + sin codificar se decodifica como un espacio y el valor deja de poder interpretarse) o solo una fecha (2026-10-01), que equivale a las 00:00:00 UTC de ese día. Un valor sin desfase se interpreta como UTC. No se aceptan valores en ningún otro formato.

Coincidencia de subcadena, sin distinguir mayúsculas y minúsculas, en event_id, action_type, subject_vendor_data o counterparty_vendor_data.

Respuesta

Una página de los eventos del sujeto.

Una página de eventos de monitorización, con el occurred_at más reciente primero.

count
integer
requerido

Número de eventos coincidentes, exacto hasta 100 y limitado a 100 por encima de esa cifra. No calcules el número de páginas a partir de él; sigue next hasta que sea null.

next
string<uri> | null
requerido

URL de la página siguiente, o null en la última página.

previous
string<uri> | null
requerido

URL de la página anterior, o null en la primera página.

results
object[]
requerido
Última modificación el 1 de noviembre de 2026