Access events (paginated)

get

https://api.tatum.io/v4/logs/access/events

Individual access events, paginated with a keyset cursor over
(timestamp, req_id). Pass next_cursor from the previous response back
as cursor to fetch the next page.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

cursor

string

length ≤ 512

Opaque keyset cursor from the previous page's next_cursor. Omit for the
first page.

limit

integer

1 to 1000

Maximum rows to return (1–1000). Defaults to the endpoint's page size when
omitted.

string

length ≤ 128

^[^\x00-\x1f\x7f]*$

Free-text search across event fields (URI, method, ids). Control bytes are
rejected; max 128 chars.

time_range

Relative look-back window. Ignored when from/to are supplied.

from

date-time

Inclusive window start, ISO-8601. Use together with to for an explicit
range instead of time_range.

date-time

Exclusive window end, ISO-8601. Defaults to now when only from is given.

filter[status_code][in]

array of int32s

Include rows where status_code (HTTP response status code) is one of the given values. Repeat the parameter to pass multiple values.

filter[status_code][in]

filter[status_code][nin]

array of int32s

Exclude rows where status_code (HTTP response status code) is none of the given values. Repeat the parameter to pass multiple values.

filter[status_code][nin]

filter[status_code][between]

array of int32s

length between 2 and 2

Include rows where status_code (HTTP response status code) falls within an inclusive numeric range (SQL BETWEEN lo AND hi). Pass the parameter exactly twice: first the lower bound, then the upper bound.

filter[status_code][between]

filter[network][in]

array of strings

Include rows where network (blockchain network (chain-qualified)) is one of the given values. Repeat the parameter to pass multiple values.

filter[network][in]

filter[network][nin]

array of strings

Exclude rows where network (blockchain network (chain-qualified)) is none of the given values. Repeat the parameter to pass multiple values.

filter[network][nin]

filter[gateway_id][in]

array of strings

Include rows where gateway_id (gateway identifier) is one of the given values. Repeat the parameter to pass multiple values.

filter[gateway_id][in]

filter[gateway_id][nin]

array of strings

Exclude rows where gateway_id (gateway identifier) is none of the given values. Repeat the parameter to pass multiple values.

filter[gateway_id][nin]

filter[gateway_id][contains]

string

length ≤ 128

Include rows where gateway_id (gateway identifier) contains this substring (SQL LIKE '%value%').

filter[interface_id][in]

array of strings

Include rows where interface_id (interface identifier) is one of the given values. Repeat the parameter to pass multiple values.

filter[interface_id][in]

filter[interface_id][nin]

array of strings

Exclude rows where interface_id (interface identifier) is none of the given values. Repeat the parameter to pass multiple values.

filter[interface_id][nin]

filter[interface_id][contains]

string

length ≤ 128

Include rows where interface_id (interface identifier) contains this substring (SQL LIKE '%value%').

filter[method][in]

array of strings

Include rows where method (HTTP / RPC method) is one of the given values. Repeat the parameter to pass multiple values.

filter[method][in]

filter[method][nin]

array of strings

Exclude rows where method (HTTP / RPC method) is none of the given values. Repeat the parameter to pass multiple values.

filter[method][nin]

filter[method][contains]

string

length ≤ 128

Include rows where method (HTTP / RPC method) contains this substring (SQL LIKE '%value%').

filter[source][in]

array of strings

Include rows where source (traffic source / attribution channel) is one of the given values. Repeat the parameter to pass multiple values.

filter[source][in]

filter[source][nin]

array of strings

Exclude rows where source (traffic source / attribution channel) is none of the given values. Repeat the parameter to pass multiple values.

filter[source][nin]

filter[region][in]

array of strings

Include rows where region (serving region) is one of the given values. Repeat the parameter to pass multiple values.

filter[region][in]

filter[region][nin]

array of strings

Exclude rows where region (serving region) is none of the given values. Repeat the parameter to pass multiple values.

filter[region][nin]

filter[req_id][in]

array of strings

Include rows where req_id (request id (exact lookup)) is one of the given values. Repeat the parameter to pass multiple values.

filter[req_id][in]

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A keyset-paginated page of individual access events.

401Unauthorized