Skip to content

Deel: Retrieve the ATS activity timeline

Deel ats.retrieveAlistOfAtsOperationHistoryLogs: arguments, response, policy and SDK examples.

← ATS operations · Get started

Operation deel.ats_retrievealistofatsoperationhistorylogs_v2026_10_28

Provider route: GET /ats/operation-history-logs. 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["ats"]["retrieveAlistOfAtsOperationHistoryLogs"]>[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.ats.retrieveAlistOfAtsOperationHistoryLogs(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.ats.retrieve_alist_of_ats_operation_history_logs(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
queryobjectOptionalAdditional keys: not allowed
query.cursorstringOptionalMaximum length: 1000
query.limitintegerOptionalDefault: 30
Maximum: 100
Minimum: 1
query.candidate_idsarrayOptional
query.candidate_ids[]stringEach itemFormat: uuid
query.application_idsarrayOptional
query.application_ids[]stringEach itemFormat: uuid
query.job_idsarrayOptional
query.job_ids[]stringEach itemFormat: uuid
query.categoriesarrayOptional
query.categories[]stringEach itemOne of: JOB, OFFER, JOB_POSTING, CANDIDATE, APPLICATION, JOB_ACTIVITY, SCHEDULED_INTERVIEW, APPLICATION_ACTIVITY, OPENING, COMPENSATION, CANDIDATE_EMAIL_BLOCKLIST_ENTRY, ORGANIZATION_SETTINGS, CANDIDATE_FOLLOW_UP_REMINDER
query.created_by_hris_organization_user_idsarrayOptional
query.created_by_hris_organization_user_ids[]stringEach itemFormat: uuid
query.date_range_startstringOptionalFormat: date-time
query.date_range_endstringOptionalFormat: date-time
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 Retrieve the ATS activity timeline — 200 response body

Referenced models: Retrieve the ATS activity timeline — 200 response body

Retrieve the ATS activity timeline — 200 response body
FieldTypePresenceDescription and constraints
$objectRoot
dataarrayRequired within parentPage of activity entries, newest first.
data[]ModelEach itemExpand Retrieve the ATS activity timeline — 200 response body — data item
has_morebooleanRequired within parentWhether more pages are available.
next_cursorJSONRequired within parent
next_cursor (anyOf 1)stringAlternativeCursor to fetch the next page; null when there are no more pages.
next_cursor (anyOf 2)nullAlternativeCursor to fetch the next page; null when there are no more pages.
total_countJSONRequired within parent
total_count (anyOf 1)integerAlternativeTotal number of entries matching the filters.
total_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: Retrieve the ATS activity timeline — 200 response body — data item

Retrieve the ATS activity timeline — 200 response body — data item
FieldTypePresenceDescription and constraints
$objectRoot
application_idJSONOptional
application_id (anyOf 1)stringAlternativeApplication the change relates to, if any
Format: uuid
application_id (anyOf 2)nullAlternativeApplication the change relates to, if any
Format: uuid
candidate_idJSONOptional
candidate_id (anyOf 1)stringAlternativeCandidate the change relates to, if any
Format: uuid
candidate_id (anyOf 2)nullAlternativeCandidate the change relates to, if any
Format: uuid
categorystringRequired within parentKind of record that changed
Known values: JOB, OFFER, JOB_POSTING, CANDIDATE, APPLICATION, JOB_ACTIVITY, SCHEDULED_INTERVIEW, APPLICATION_ACTIVITY, OPENING, COMPENSATION, CANDIDATE_EMAIL_BLOCKLIST_ENTRY, ORGANIZATION_SETTINGS, CANDIDATE_FOLLOW_UP_REMINDER
changesarrayRequired within parentFields that changed. Empty for events that carry no field changes.
changes[]ModelEach itemExpand Retrieve the ATS activity timeline — 200 response body — data item changes item
created_atstringRequired within parentWhen the change happened
Format: date-time
created_by_hris_organization_user_idJSONOptional
created_by_hris_organization_user_id (anyOf 1)stringAlternativeHRIS organization user who made the change. Null for changes made by the system or an automation.
Format: uuid
created_by_hris_organization_user_id (anyOf 2)nullAlternativeHRIS organization user who made the change. Null for changes made by the system or an automation.
Format: uuid
idstringRequired within parentUnique identifier of the entry
Format: uuid
job_idJSONOptional
job_id (anyOf 1)stringAlternativeJob the change relates to, if any
Format: uuid
job_id (anyOf 2)nullAlternativeJob the change relates to, if any
Format: uuid
loggable_entity_idstringRequired within parentID of the record that changed
Format: uuid
operation_typeModelRequired within parentExpand Retrieve the ATS activity timeline — 200 response body — data item operation type
What happened to the record

Referenced models: Retrieve the ATS activity timeline — 200 response body — data item changes item, Retrieve the ATS activity timeline — 200 response body — data item operation type

Retrieve the ATS activity timeline — 200 response body — data item changes item
FieldTypePresenceDescription and constraints
$objectRoot
afterJSONRequired within parent
after (anyOf 1)stringAlternativeValue after the change. Non-string values are JSON-encoded. Null when the field was cleared.
after (anyOf 2)nullAlternativeValue after the change. Non-string values are JSON-encoded. Null when the field was cleared.
beforeJSONRequired within parent
before (anyOf 1)stringAlternativeValue before the change. Non-string values are JSON-encoded. Null when the field was not set.
before (anyOf 2)nullAlternativeValue before the change. Non-string values are JSON-encoded. Null when the field was not set.
fieldstringRequired within parentName of the changed field
Retrieve the ATS activity timeline — 200 response body — data item operation type
FieldTypePresenceDescription and constraints
$stringRootWhat happened to the record
Known values: JOB_UPDATED, JOB_HIRING_MEMBER_ADDED, JOB_HIRING_MEMBER_REMOVED, JOB_HIRING_MEMBER_UPDATED, OFFER_CREATED, OFFER_ACCEPTED, OFFER_DECLINED, OFFER_SUBMITTED_FOR_APPROVAL, OFFER_APPROVED, OFFER_APPROVAL_REJECTED, OFFER_DELETED, OFFER_UPDATED, OFFER_SENT, OFFER_RESENT, OFFER_SENT_OUTSIDE_DEEL, OFFER_RECORDED, OFFER_ACCEPTANCE_UNDONE, OFFER_DECLINE_UNDONE, JOB_POSTING_CREATED, JOB_POSTING_UPDATED, JOB_POSTING_PUBLISHED, JOB_POSTING_UNPUBLISHED, JOB_POSTING_ARCHIVED, JOB_POSTING_PUBLICATION_UPDATED, JOB_POSTING_AUDIENCE_UPDATED, COMPENSATION_CREATED, COMPENSATION_UPDATED, COMPENSATION_DELETED, CANDIDATE_DELETED, CANDIDATE_ANONYMIZED, CANDIDATE_AUTOMATICALLY_TAGGED, CANDIDATE_CREATED, CANDIDATE_AUTO_MERGED, CANDIDATE_UPDATED, CANDIDATE_LOCATION_UPDATED, APPLICATION_TRANSITIONED, APPLICATION_AUTO_TRANSITIONED, JOB_ACTIVITY_CREATED, JOB_ACTIVITY_UPDATED, JOB_ACTIVITY_DELETED, INTERVIEW_SCHEDULED, INTERVIEWER_ADDED, INTERVIEWER_REMOVED, INTERVIEW_UPDATED, INTERVIEW_CANCELLED, INTERVIEW_SLOT_REQUEST_SENT, INTERVIEW_SLOTS_SUBMITTED, INTERVIEW_MANUALLY_LOGGED, APPLICATION_EVALUATION_PARTICIPANT_ADDED, APPLICATION_EVALUATION_PARTICIPANT_REMOVED, APPLICATION_EVALUATION_FEEDBACK_SUBMITTED, APPLICATION_ACTIVITY_FEEDBACK_DISMISSED, APPLICATION_ACTIVITY_FEEDBACK_DISMISSAL_REVERTED, APPLICATION_ACTIVITY_CREATED, APPLICATION_ACTIVITY_DELETED, EMAIL_SENT, EMAIL_SCHEDULED, AUTOMATED_EMAIL_SENT, JOB_INTERVIEW_PLAN_UPDATED, OFFER_EXPIRED, OFFER_PENDING_CREATION, OPENING_CREATED, OPENING_UPDATED, OPENING_DELETED, OPENING_SUBMITTED_FOR_APPROVAL, OPENING_APPROVED, OPENING_REJECTED, APPLICATION_SOURCE_UPDATED, APPLICATION_SOURCE_CHANNEL_UPDATED, JOB_PRIVATE_NOTE_CREATED, JOB_PRIVATE_NOTE_UPDATED, JOB_PRIVATE_NOTE_DELETED, CANDIDATE_EMAIL_BLOCKLISTED, CANDIDATE_EMAIL_UNBLOCKLISTED, ORGANIZATION_SETTINGS_UPDATED, SECURITY_STATE_CHANGED, CANDIDATE_FOLLOW_UP_REMINDER_CREATED, CANDIDATE_FOLLOW_UP_REMINDER_UPDATED, CANDIDATE_FOLLOW_UP_REMINDER_COMPLETED, CANDIDATE_FOLLOW_UP_REMINDER_DELETED

SDK function policy ID: deel.ats_retrievealistofatsoperationhistorylogs_v2026_10_28. Catalog operation: ats_retrievealistofatsoperationhistorylogs_v2026_10_28. 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: ["ats:read", "worker:read"]

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

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.