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

Live read. Asks Meta now for the custom conversions of one ad account. A custom conversion is a rule on the events of a Pixel, such as a `StartTrial` event on a URL that contains `/welcome`. Its `id` is the `customConversionId` of an ad set that optimizes for it.

`usable` is false when Meta archived the custom conversion or made it unavailable: an ad set cannot optimize for it. `lastFiredTime` tells which custom conversion receives events. When no page holds a custom conversion, 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-conversions`

**Responses**

- `200` — The custom conversions 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": [
    {
      "customEventType": "START_TRIAL",
      "id": "901234567890123",
      "lastFiredTime": "2026-09-24T07:58:40+0000",
      "name": "Trial started",
      "pixelId": "812345678901234",
      "rule": "{\"and\":[{\"event\":{\"eq\":\"StartTrial\"}},{\"url\":{\"i_contains\":\"/welcome\"}}]}",
      "usable": true
    },
    {
      "customEventType": "LEAD",
      "id": "901234567890124",
      "lastFiredTime": null,
      "name": "Old lead form",
      "pixelId": "812345678901234",
      "rule": "{\"and\":[{\"event\":{\"eq\":\"Lead\"}}]}",
      "usable": false
    }
  ]
}
```
