HiringRead-only annotation
List Hiring Candidates
list_hiring_candidates
Read client-scoped manually sourced/imported recruiting records. Prospects and recruiter-reported applications are not Afina submissions. Follow cursor, including empty filtered pages. No applicant account is linked.
Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.
Parameters
| Name | Contract |
|---|---|
client_idRequired | string |
job_idOptional | string |
limitOptional | integer |
cursorOptional | string |
Exact input schema
Expand JSON Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"client_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"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": [
"client_id"
],
"additionalProperties": false
}Output schema
Expand output contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
{
"type": "null"
}
]
},
"job_id": {
"default": null,
"anyOf": [
{
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
{
"type": "null"
}
]
},
"resume_text": {
"default": "",
"type": "string",
"maxLength": 50000
},
"relationship": {
"type": "string",
"enum": [
"prospect",
"application_reported"
]
},
"source_label": {
"type": "string",
"minLength": 3,
"maxLength": 500
},
"authority_statement": {
"type": "string",
"minLength": 20,
"maxLength": 2000
},
"source_use_authorized": {
"type": "boolean",
"const": true
},
"applied_at": {
"default": null,
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"private_note": {
"default": "",
"type": "string",
"maxLength": 3000
},
"state": {
"default": "active",
"type": "string",
"enum": [
"active",
"archived"
]
},
"version": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"created_at": {
"type": "string"
},
"created_by": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"updated_at": {
"type": "string"
},
"updated_by": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"linked_applicant": {
"type": "boolean",
"const": false
},
"delivery": {
"type": "string",
"const": "not_an_afina_submission"
},
"audience": {
"type": "string",
"const": "recruiter_only"
},
"notice": {
"type": "string"
}
},
"required": [
"client_id",
"id",
"name",
"email",
"job_id",
"resume_text",
"relationship",
"source_label",
"authority_statement",
"source_use_authorized",
"applied_at",
"private_note",
"state",
"version",
"created_at",
"created_by",
"updated_at",
"updated_by",
"linked_applicant",
"delivery",
"audience",
"notice"
],
"additionalProperties": false
}
},
"cursor": {
"type": "string"
}
},
"required": [
"candidates"
],
"additionalProperties": false
}
},
"required": [
"data"
],
"additionalProperties": false
}Tool annotations
{
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}