---
search:
  tags:
    - Custom audiences
    - GET
seo:
  description: >-
    Available on: Meta. Reference for the GET
    /observe/{advertiserId}/custom-audiences endpoint in the AdCrunch API.
sidebar:
  label: List an advertiser’s Meta Custom Audiences
  badge: GET
title: List an advertiser’s Meta Custom Audiences
type: openapi-operation
---
**Available on:** [![Meta](/providers/meta.svg)](https://docs.adcrunch.dev/connect/providers)

Live read. Asks Meta now for the Custom Audiences of one ad account. Send the `id` of an audience in `customAudiences` or `excludedCustomAudiences` when you create an ad set, or as `originAudienceId` when you create a lookalike.

`usable` is false when an ad set cannot use the audience: Meta flagged it for integrity reasons, or it is too small or cannot deliver. `operationStatus` gives the words of Meta. `source` tells a website audience, a customer list and a lookalike apart. When no page holds an audience, up to the page with no `nextCursor`, the ad account has none.

An advertiser that your organization does not own answers `404`, with `error` of `not_found`. An advertiser that does not exist, and one that is not a Meta ad account, answer the same.

AdCrunch stores nothing from this read. Each request counts against the rate limits of Meta.

`limit` and `cursor` page the answer. Send `nextCursor` back as `cursor` to get the next page. A page can hold no row and still carry `nextCursor`.

`GET /observe/{advertiserId}/custom-audiences`

**Responses**

- `200` — The Custom Audiences of this advertiser.
- `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. Or AdCrunch cannot use the \`cursor\`: it cannot read it, or the cursor belongs to a different query. Then \`error\` is \`invalid\_cursor\`. Send the \`nextCursor\` of the previous page with no change, or omit \`cursor\` to get the first page.
- `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` — Your organization does not own the advertiser in the path, it does not exist, or it is not a Meta ad account. The answer does not tell them apart. \`error\` is \`not\_found\`. AdCrunch asks Meta nothing.
- `409` — This advertiser has no usable connection to Meta. A person must reconnect it.
- `502` — The provider refused the request, or could not answer it. This failure is often transient. Send the request again.

Response example, 200:

```json
{
  "data": [
    {
      "approximateCount": {
        "lowerBound": 12400,
        "upperBound": 14600
      },
      "id": "238000000000001",
      "name": "Visitors 30 days, no trial",
      "operationStatus": "Normal",
      "source": "website",
      "usable": true
    },
    {
      "approximateCount": null,
      "id": "238000000000002",
      "name": "Lookalike 1% US of Visitors 30 days",
      "operationStatus": "This audience is being populated.",
      "source": "lookalike",
      "usable": false
    }
  ]
}
```
