Skip to content

Deel: List token activity

Deel logs.listTokenActivity: arguments, response, policy and SDK examples.

← Logs operations · Get started

Operation deel.logs_listtokenactivity_v2026_10_29

Provider route: GET /logs/tokens. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/deel with npm, or alter-sdk-deel with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { DeelIntegration } from "@alter-ai/deel";
async function execute(input: Parameters<DeelIntegration["logs"]["listTokenActivity"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new DeelIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.logs.listTokenActivity(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_deel import DeelIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = DeelIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.logs.list_token_activity(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
queryobjectOptionalAdditional keys: not allowed
query.fromstringOptionalFormat: date-time
query.tostringOptionalFormat: date-time
query.searchstringOptional
query.cursorstringOptional
query.limitintegerOptionalDefault: 50
Maximum: 100
Minimum: 1
headersobjectRequired within parentAdditional keys: not allowed
headers.X-BetastringRequired within parentDefault: true
One of: true

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$ModelRootExpand List token activity — 200 response body

Referenced models: List token activity — 200 response body

List token activity — 200 response body
FieldTypePresenceDescription and constraints
$objectRoot
dataarrayRequired within parentThe page of results, newest first
data[]ModelEach itemExpand List token activity — 200 response body — data item
pageModelRequired within parentExpand List request logs — 200 response body — page
Keyset pagination envelope for the page just returned

Referenced models: List request logs — 200 response body — page, List token activity — 200 response body — data item

List request logs — 200 response body — page
FieldTypePresenceDescription and constraints
$objectRootKeyset pagination envelope for the page just returned
cursorJSONRequired within parent
cursor (anyOf 1)stringAlternativeCursor for the next page, or null on the last page
cursor (anyOf 2)nullAlternativeCursor for the next page, or null on the last page
has_next_pagebooleanRequired within parentWhether a further page is available
List token activity — 200 response body — data item
FieldTypePresenceDescription and constraints
$objectRootOne token's activity over the window
callsJSONRequired within parent
calls (anyOf 1)integerAlternativeRequests made with the token in the window
calls (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
dailyarrayRequired within parentPer-day series over the window, oldest first
daily[]ModelEach itemExpand List token activity — 200 response body — data item daily item
errorsJSONRequired within parent
errors (anyOf 1)integerAlternativeRequests that ended in a 4xx or 5xx status
errors (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
last_ipJSONRequired within parent
last_ip (anyOf 1)stringAlternativeClient IP of that latest request
last_ip (anyOf 2)nullAlternativeClient IP of that latest request
last_used_atstringRequired within parentLatest request made with the token (UTC)
Format: date-time
tokenModelRequired within parentExpand List token activity — 200 response body — data item token
The token

Referenced models: List token activity — 200 response body — data item daily item, List token activity — 200 response body — data item token

List token activity — 200 response body — data item daily item
FieldTypePresenceDescription and constraints
$objectRootOne day of the token's activity
callsJSONRequired within parent
calls (anyOf 1)integerAlternativeRequests that day
calls (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
daystringRequired within parentUTC day
Format: date
errorsJSONRequired within parent
errors (anyOf 1)integerAlternativeRequests that day ending in a 4xx or 5xx status
errors (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
List token activity — 200 response body — data item token
FieldTypePresenceDescription and constraints
$objectRootThe token
idstringRequired within parentToken id shown in the Developer Center
Format: uuid
labelJSONRequired within parent
label (anyOf 1)stringAlternativeToken label or OAuth2 client name at its latest use
label (anyOf 2)nullAlternativeToken label or OAuth2 client name at its latest use
typestringRequired within parentPersonal access token or OAuth2 access token
Known values: pat, oauth2

SDK function policy ID: deel.logs_listtokenactivity_v2026_10_29. Catalog operation: logs_listtokenactivity_v2026_10_29. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["api-logs:read"]

Pinned headers: {"X-Version": "2026-10-29"}

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.