Skip to navigation

List token activity

Beta

Returns, per token of the organization seen in the window, the number of calls and errors, the last use and IP, and a per-day series. Use it to find unused or noisy tokens. Window of at most 15 days (default: the last 24 hours); search matches the token label or id.

Token scopes: api-logs:read

Beta: this version requires the X-Beta: true request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-01-13.

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.deel.training/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Headers

X-BetaenumRequiredDefaults to true

Opts in to the beta version of this endpoint. Must be true.

Allowed values:

Query parameters

fromstringOptionalformat: "date-time"

Start of the window (ISO-8601). Defaults to 24 hours before to; a window wider than 15 days is clamped

tostringOptionalformat: "date-time"

End of the window (ISO-8601). Defaults to now

searchstringOptional

Only tokens whose label or id contains this text (case-insensitive)

cursorstringOptional

Cursor for keyset pagination, taken from a previous response page.cursor

limitintegerOptional1-100Defaults to 50
Page size

Response

A page of token activity, most recently used first
datalist of objects
The page of results, newest first
pageobject
Keyset pagination envelope for the page just returned

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error