ApplicantRead-only annotation
Get Application Timeline
get_application_timeline
Read source-labelled application history. Applicants see only shared events for their own application; recruiters need current client access. Follow cursor even through empty filtered pages. The current receipt is separate from historical events; missing history never proves an employer decision.
Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.
Parameters
| Name | Contract |
|---|---|
job_idRequired | string |
application_idRequired | string |
limitOptional | integer |
cursorOptional | string |
Exact input schema
Expand JSON Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"application_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"type": "string",
"maxLength": 300
}
},
"required": [
"job_id",
"application_id"
],
"additionalProperties": false
}Output schema
Expand output contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"receipt": {
"type": "object",
"properties": {
"application_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"job_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"status": {
"type": "string",
"enum": [
"draft",
"received",
"withdrawn"
]
},
"delivery": {
"type": "string",
"enum": [
"received_in_platform_inbox",
"not_sent"
]
},
"recruiter_status": {
"anyOf": [
{
"type": "string",
"enum": [
"reviewing",
"interview",
"declined",
"hired"
]
},
{
"type": "null"
}
]
},
"external_ats_delivery": {
"type": "string",
"const": "not_part_of_native_receipt"
},
"external_receipts_tool": {
"type": "string",
"const": "list_ats_exports"
}
},
"required": [
"application_id",
"job_id",
"status",
"delivery",
"recruiter_status",
"external_ats_delivery",
"external_receipts_tool"
],
"additionalProperties": {}
},
"snapshot": {
"type": "object",
"properties": {
"source": {
"type": "string",
"const": "current_record_snapshot"
},
"historical_transitions_complete": {
"type": "boolean",
"const": false
},
"notice": {
"type": "string"
}
},
"required": [
"source",
"historical_transitions_complete",
"notice"
],
"additionalProperties": false
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"type": {
"type": "string"
},
"at": {
"type": "string"
},
"source": {
"type": "string"
},
"audience": {
"type": "string",
"enum": [
"shared",
"recruiter"
]
},
"summary": {
"type": "string"
},
"actor": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
}
},
"required": [
"id",
"type",
"at",
"source",
"audience",
"summary"
],
"additionalProperties": false
}
},
"cursor": {
"type": "string"
}
},
"required": [
"receipt",
"snapshot",
"events"
],
"additionalProperties": false
}
},
"required": [
"data"
],
"additionalProperties": false
}Tool annotations
{
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}