The request
Reference for Get click id report, HeadHoncho API v1. It is a read, sent to the base address https://api.headhoncho.app.
GET /api/v1/reports/google-click-ids
The key or app needs the Click IDs and conversions 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 |
|---|---|---|---|---|
from | date, in the query | Yes | The first day. A job is in the range when it opened or closed in it. | 2026-10-01 |
to | date, in the query | Yes | The last day, inclusive. | 2026-10-31 |
company_id | id, in the query | No | Default: every company the credential reaches. | cmp_14f5 |
What comes back
rows in the agency's fifteen columns, and totals: jobs, closed, with_click_id, with_call, total, company_total; plus calls, calls_with_click_id and calls_without_click_id for the range, because a call with no click id can never be in any file, whatever anyone does downstream.
It never changes a record. It only reads the companies the key reaches. Why this report is in the API: Owner, 2026-10-14: the one report in the starter, because the file is handed to Google by the customer and must exist outside the app.
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 conversion: What this job told the ad platform it was worth: the click it came from, each conversion sent, its value and its basis, and what Google did with it.
- Export click id report: The Google Click ID report as a file: the agency's sheet, or the Google Ads offline conversion upload file, ready to upload.
- The same records in the app: offline conversion tracking.
- How the API fits together: the model, API keys, errors and the MCP server.