hires_list_jobs
List jobs with filters by status, date range, department, or search. Returns paginated results for career-site sync, reporting, and external system indexing.
Instructions
List jobs with optional filters by status, date range, department, or search query. Returns paginated results. Use for career-site sync, reporting, and external system indexing.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "hires_list_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search by job title or internal title (partial match) | |
| page | No | Page number (default 1) | |
| size | No | Page size (default 20) | |
| status | No | Filter by job status name (from GET /taxonomy/statuses, e.g. Public, Draft, Archived) | |
| include | No | Comma-separated related resources to embed: workflow, hiring_team, pipeline_stages | |
| company_id | No | Filter by company ID (required only for multi-company API keys) | |
| department_id | No | Filter jobs by department ID (from GET /taxonomy/departments) | |
| updated_after | No | Return only jobs updated after this Unix timestamp (seconds). Use for incremental sync. | |
| created_at_end | No | Return only jobs created at or before this Unix timestamp (seconds) | |
| created_at_start | No | Return only jobs created at or after this Unix timestamp (seconds) |