---
title: "Live read: Get one asset group"
method: GET
path: "/observe/{advertiserId}/asset-groups/{id}"
tags: ["Asset groups"]
---

# Live read: Get one asset group

`GET /observe/{advertiserId}/asset-groups/{id}`

## Request

- Base URL: `https://api.adcrunch.dev`
- URL: `https://api.adcrunch.dev/observe/{advertiserId}/asset-groups/{id}`
- Auth: HTTP bearer

**Available on:** [![Google Ads](/providers/gads.svg)](https://docs.adcrunch.dev/connect/providers)

Asks the provider for one asset group now, and gives its payload exactly as Google Ads sends it: its `id`, its `name`, its `status` and the `campaignId` of the Performance Max campaign that holds it.

**Those four keys are the whole payload.** AdCrunch reads an asset group with one query, and the headlines, the images, the videos and the audience signals are separate Google Ads resources that this API does not read.

## When there is nothing to give

**`404`** — the provider holds no such asset group on this ad account, the provider has no asset group at all, or your organization does not own the advertiser in the path. They are deliberately not told apart: distinguishing them would confirm that a asset group exists to somebody who cannot read it.

## Path parameters

- `advertiserId` string, required: The ad account to read, prefixed `acc_`. It must belong to your organization. One that does not answers `404`, with `error` of `not_found`.
- `id` string, required: The id the provider gives, with no prefix. Every listing answers it as `id`.

## Response `200`

The payload the provider holds now, verbatim.

- unknown

## Other responses

- `400`: The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. `error` is `invalid_request`, and `issues` names each field. Nothing was changed.
- `401`: No API key, or one that does not resolve. See the security scheme. `error` is `unauthorized`.
- `402`: The organization has no active subscription. An owner subscribes at `paywallUrl`. `error` is `organization_unentitled`.
- `403`: The caller does not hold `observe:read`. `error` is `forbidden`.
- `404`: The provider holds no such entity on this ad account, the provider does not have this kind of entity, or your organization does not own the advertiser in the path. They are deliberately not told apart. `error` is `not_found`.
- `409`: This advertiser has no usable connection to its provider. A person must reconnect it. The stored read of the same resource, with `advertiserId`, still answers what AdCrunch holds.
- `501`: AdCrunch cannot read this resource live from this advertiser’s provider. It is permanent. Read the stored copy instead, at the same resource without the advertiser in the path and with `advertiserId`.
- `502`: The provider refused the request, or could not answer it. Often transient, so a retry is worth making.

---

[API](https://skmtc.dev/adcrunch/apis/adcrunch-api.md) · [All operations](https://skmtc.dev/adcrunch/apis/adcrunch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adcrunch/apis/adcrunch-api/revisions/a420ba80914f?raw)