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.
Call through Alter
Section titled “Call through Alter”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 osfrom alter_sdk import Appfrom 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()| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Additional keys: not allowed |
query | object | Optional | Additional keys: not allowed |
query.cursor | string | Optional | Maximum length: 1000 |
query.limit | integer | Optional | Default: 30 Maximum: 100 Minimum: 1 |
query.candidate_ids | array | Optional | |
query.candidate_ids[] | string | Each item | Format: uuid |
query.application_ids | array | Optional | |
query.application_ids[] | string | Each item | Format: uuid |
query.job_ids | array | Optional | |
query.job_ids[] | string | Each item | Format: uuid |
query.categories | array | Optional | |
query.categories[] | string | Each item | One 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_ids | array | Optional | |
query.created_by_hris_organization_user_ids[] | string | Each item | Format: uuid |
query.date_range_start | string | Optional | Format: date-time |
query.date_range_end | string | Optional | Format: date-time |
headers | object | Required within parent | Additional keys: not allowed |
headers.X-Beta | string | Required within parent | Default: true One of: true |
Response
Section titled “Response”Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | Model | Root | Expand Retrieve the ATS activity timeline — 200 response body |
Referenced models: Retrieve the ATS activity timeline — 200 response body
Schemas
Section titled “Schemas”Retrieve the ATS activity timeline — 200 response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
data | array | Required within parent | Page of activity entries, newest first. |
data[] | Model | Each item | Expand Retrieve the ATS activity timeline — 200 response body — data item |
has_more | boolean | Required within parent | Whether more pages are available. |
next_cursor | JSON | Required within parent | |
next_cursor (anyOf 1) | string | Alternative | Cursor to fetch the next page; null when there are no more pages. |
next_cursor (anyOf 2) | null | Alternative | Cursor to fetch the next page; null when there are no more pages. |
total_count | JSON | Required within parent | |
total_count (anyOf 1) | integer | Alternative | Total number of entries matching the filters. |
total_count (anyOf 2) | string | Alternative | Pattern: ^-?[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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
application_id | JSON | Optional | |
application_id (anyOf 1) | string | Alternative | Application the change relates to, if any Format: uuid |
application_id (anyOf 2) | null | Alternative | Application the change relates to, if any Format: uuid |
candidate_id | JSON | Optional | |
candidate_id (anyOf 1) | string | Alternative | Candidate the change relates to, if any Format: uuid |
candidate_id (anyOf 2) | null | Alternative | Candidate the change relates to, if any Format: uuid |
category | string | Required within parent | Kind 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 |
changes | array | Required within parent | Fields that changed. Empty for events that carry no field changes. |
changes[] | Model | Each item | Expand Retrieve the ATS activity timeline — 200 response body — data item changes item |
created_at | string | Required within parent | When the change happened Format: date-time |
created_by_hris_organization_user_id | JSON | Optional | |
created_by_hris_organization_user_id (anyOf 1) | string | Alternative | HRIS 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) | null | Alternative | HRIS organization user who made the change. Null for changes made by the system or an automation. Format: uuid |
id | string | Required within parent | Unique identifier of the entry Format: uuid |
job_id | JSON | Optional | |
job_id (anyOf 1) | string | Alternative | Job the change relates to, if any Format: uuid |
job_id (anyOf 2) | null | Alternative | Job the change relates to, if any Format: uuid |
loggable_entity_id | string | Required within parent | ID of the record that changed Format: uuid |
operation_type | Model | Required within parent | Expand 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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
after | JSON | Required within parent | |
after (anyOf 1) | string | Alternative | Value after the change. Non-string values are JSON-encoded. Null when the field was cleared. |
after (anyOf 2) | null | Alternative | Value after the change. Non-string values are JSON-encoded. Null when the field was cleared. |
before | JSON | Required within parent | |
before (anyOf 1) | string | Alternative | Value before the change. Non-string values are JSON-encoded. Null when the field was not set. |
before (anyOf 2) | null | Alternative | Value before the change. Non-string values are JSON-encoded. Null when the field was not set. |
field | string | Required within parent | Name of the changed field |
Retrieve the ATS activity timeline — 200 response body — data item operation type
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | string | Root | What 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 |
Policy, approvals and errors
Section titled “Policy, approvals and errors”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"}