HiringRead-only annotation
Get Pipeline
get_pipeline
Read a page of the client job's internal recruiting pipeline. Internal stages are distinct from shared applicant status. Follow cursor; counts describe only the loaded page. Withdrawn materials remain hidden.
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 |
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}$"
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"type": "string",
"maxLength": 300
}
},
"required": [
"job_id"
],
"additionalProperties": false
}Output schema
Expand output contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"applications": {
"type": "array",
"items": {
"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"
},
"stage": {
"anyOf": [
{
"type": "string",
"enum": [
"received",
"reviewing",
"interview",
"offer",
"declined",
"hired"
]
},
{
"type": "string",
"const": "withdrawn"
}
]
},
"version": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"allowed_stages": {
"type": "array",
"items": {
"type": "string",
"enum": [
"received",
"reviewing",
"interview",
"offer",
"declined",
"hired"
]
}
},
"materials": {
"anyOf": [
{
"type": "object",
"properties": {
"applicant_name": {
"type": "string"
},
"email": {
"type": "string"
},
"resume_text": {
"type": "string"
}
},
"required": [
"applicant_name",
"email",
"resume_text"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"application_id",
"job_id",
"status",
"delivery",
"recruiter_status",
"external_ats_delivery",
"external_receipts_tool",
"stage",
"version",
"allowed_stages",
"materials"
],
"additionalProperties": {}
}
},
"cursor": {
"type": "string"
},
"stages": {
"type": "array",
"items": {
"type": "string",
"enum": [
"received",
"reviewing",
"interview",
"offer",
"declined",
"hired"
]
}
},
"stage_definitions": {
"minItems": 6,
"maxItems": 6,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"enum": [
"received",
"reviewing",
"interview",
"offer",
"declined",
"hired"
]
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"allowed_next": {
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"received",
"reviewing",
"interview",
"offer",
"declined",
"hired"
]
}
}
},
"required": [
"id",
"label",
"allowed_next"
],
"additionalProperties": false
}
},
"pipeline_version": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"counts_scope": {
"type": "string",
"const": "loaded_page"
},
"notice": {
"type": "string"
}
},
"required": [
"applications",
"stages",
"stage_definitions",
"pipeline_version",
"counts_scope",
"notice"
],
"additionalProperties": false
}
},
"required": [
"data"
],
"additionalProperties": false
}Tool annotations
{
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}