Inspect stored Google Ads connection

GET/sites/{site_id}/google-ads/connectiongoogle-ads:read

OVERVIEW

Requires google-ads:read. Stored reads only: no source=live, refresh, GAQL, provider account overrides, jobs, or credit charges. Explicit site grants and current campaign assignments constrain reports. Shared account collection coverage never grants other-site metrics.

Request	`GET https://satelliteai.io/api/v1/sites/{site_id}/google-ads/connection`
Permission	`google-ads:read`
Response	A single object: `data` is `GoogleAdsConnection`.
Operation ID	`getGoogleAdsConnection`

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/google-ads/connection' \
  -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

Unknown or repeated query parameters return 400.

RESPONSE

Data dictionary

Stored site-assigned results. No provider refresh or credit debit.

[] 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.site_id`	integeralways present	Satellite site ID (from GET /sites).
`data.connected`	booleanalways present
`data.visible_accounts`	integeralways present
`data.report_types`	array of stringalways present	max items 11
`data.entity_types`	array of stringalways present	max items 4
`data.stored_only`	booleanalways present	one of: True

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.source`	stringalways present	one of: stored · max length 4096
`meta.access_scope`	string	one of: site · max length 4096
`meta.connection_status`	string	max length 128
`meta.offset`	integer	min 0 · max 100000
`meta.next_offset`	integernullable	min 0 · max 100000
`meta.offset_limit_reached`	boolean

ERRORS

Error responses

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

HTTP	When
`400`	Unknown/repeated query, invalid filter or dates. summary rejects limit/offset; variant filters are only accepted by their corresponding report.
`401`	Missing, invalid, expired, or revoked credential.
`403`	Required explicit scope, active integration, or company API access unavailable.
`404`	Missing or inaccessible site, account, campaign, report, entity type, or dataset.
`409`	google_ads_timezone_unavailable: stored account time zone needs correction.
`413`	Response too large.
`429`	Request allowance exceeded; honor Retry-After.
`503`	Stored reporting or authentication temporarily unavailable.