Docs
HiringRead-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

NameContract
job_id
Required
string
application_id
Required
string
limit
Optional
integer
cursor
Optional
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
}

← All hiring tools · Review and receipts