The request
Reference for List jobs, HeadHoncho API v1. It is a read, sent to the base address https://api.headhoncho.app.
GET /api/v1/jobs
The key or app needs the Jobs area at read. It counts as a read call: 300 a minute for each key or connected app. See rate limits.
Send your key as Authorization: Bearer hh_live_.... See API keys.
Parameters
| Name | Kind | Required | Description | Example |
|---|---|---|---|---|
company_id | id, in the query | No | One company. Default: every company the credential reaches. | cmp_14f5 |
status | text, in the query | No | A status name or slug from Who am I. | scheduled |
worker_id | id, in the query | No | Jobs this technician or subcontractor is on. | wrk_3b90 |
from | date, in the query | No | Created on or after this day, in the company's time zone. | 2026-10-01 |
to | date, in the query | No | Created on or before this day. | 2026-10-31 |
leads | text, in the query | No | include (default), only, or exclude. One of include, only, exclude. | include |
limit | number, in the query | No | 1 to 200. Default 50. | 50 |
cursor | text, in the query | No | From the previous answer's next. | eyJhZnRlciI6... |
What comes back
items, one job each in the Get a job shape; next, a cursor for the following page or null; count, how many match in all. Trashed jobs are never listed.
It never changes a record. It only reads the companies the key reaches.
Errors that apply
| Code | Status | What it means |
|---|---|---|
| `missing_key` | 401 | Send your key as Authorization: Bearer hh_live_... |
| `unknown_key` | 401 | That key is not one we issued, or it was revoked. |
| `expired_token` | 401 | That token has expired. Refresh it, or connect the app again. |
| `no_access` | 403 | This credential does not reach that. Ask the person who made it for access. |
| `not_found` | 404 | No such record in the companies this credential reaches. |
| `out_of_scope` | 404 | No such company in the companies this credential reaches. |
| `invalid` | 422 | Some fields were refused. See fields. |
| `rate_limited` | 429 | Too many calls this minute. Wait and try again. |
Related
- Get job: One job or lead: who, where, when, which status, which technicians, the money on it and the ad click it came from.
- Get job history: Everything that happened to a job, in order, with who did it: created, moved, assigned, noted, paid. The same log the job page shows.
- The same records in the app: the Jobs panel.
- How the API fits together: the model, API keys, errors and the MCP server.