Poll an authorized site's GA4 collection job

GET/sites/{site_id}/ga4/jobs/{job_id}analytics:read

OVERVIEW

Requires analytics:read. Does not require jobs:read. Only ga4-store-collect jobs within the granted company/site are visible. Returns the standard Job DTO without worker messages or internal output. Repeat the report GET when status is succeeded.

Request	`GET https://satelliteai.io/api/v1/sites/{site_id}/ga4/jobs/{job_id}`
Permission	`analytics:read`
Response	A single object: `data` is `Job`.
Operation ID	`getGa4CollectionJob`

More context and worked examples are in the developer guide.

REQUEST

Example request

cURL · Bash

curl --fail-with-body \
  'https://satelliteai.io/api/v1/sites/123/ga4/jobs/JOB_ID' \
  -H "Authorization: Bearer $SATELLITE_API_KEY"

Replace the example IDs with values returned by the discovery endpoints. Example values are placeholders, not real records.

Parameters

Name	In	Type	Description
`site_id`required	path	integer	ID from GET /sites. min 1
`job_id`required	path	string

Unknown or repeated query parameters return 400.

RESPONSE

Data dictionary

Current collection job state. Durable job status. Reads do not clean up or modify jobs; historical records without an identifiable state return unknown.

[] marks an array element. nullable means the value can be null; treat it as unknown, not zero. always present means the key is always included in the object.

Fields in data
Field	Type	Description
`data.id`	string	Satellite identifier for this record.
`data.site_id`	integer	Satellite site ID (from GET /sites).
`data.job_type`	stringnullable
`data.status`	string	one of: accepted, queued, running, succeeded, failed, cancelled, cancel_requested, unknown
`data.created_at`	string (date-time)nullable	When Satellite created the record (UTC, RFC 3339).
`data.updated_at`	string (date-time)nullable	When Satellite last updated the record (UTC, RFC 3339).
`data.started_at`	string (date-time)nullable
`data.completed_at`	string (date-time)nullable
`data.result_links`	array of string	Authorized relative result URLs only when their required read scope is present. No embedded outputs or worker diagnostics.

Response metadata

Fields in meta
Field	Type	Description
`meta.request_id`	stringalways present	Request identifier; also returned in X-Request-ID. Include it in support requests.
`meta.api_version`	stringalways present	API version that produced the response. one of: v1
`meta.limit`	integer	Maximum records per page applied to this request. min 1 · max 100
`meta.has_more`	boolean	True when another page is available.
`meta.next_cursor`	stringnullable	Opaque cursor for the next page; send as cursor. Null on the last page.
`meta.availability`	string	available when stored data exists; not_available when it does not. one of: available, not_available
`meta.billing`	object	Present for paid live SERP requests; replayed receipts describe the original debit, not an additional charge.
`meta.billing.operation`	stringalways present	one of: client_api_serp_refresh
`meta.billing.credits_charged`	integeralways present	min 0
`meta.billing.transaction_id`	integeralways present
`meta.billing.replayed`	booleanalways present

ERRORS

Error responses

Errors return {"error": {"code", "message", "request_id"}}. See error handling for retry guidance.

HTTP	When
`403`	Missing analytics:read.
`404`	Missing, inaccessible, or non-GA4 job.