---
title: "List conversion destinations"
method: GET
path: "/v1/ads/conversions/destinations"
tags: ["Conversions"]
---

# List conversion destinations

`GET /v1/ads/conversions/destinations`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/ads/conversions/destinations`
- Auth: HTTP bearer

Lists where an ad account can receive conversion events (pixels, conversion actions or rules), so you know where to send them.

Returns the list of pixels (Meta), conversion actions (Google),
conversion rules (LinkedIn), pixels (OpenAI Ads, Reddit) or ad accounts
(Pinterest) accessible to the connected ads account. Use the returned `id` as `destinationId` when
posting to `POST /v1/ads/conversions`.

For Google and LinkedIn, each destination's `type` reflects the
conversion type (PURCHASE, LEAD, SIGN_UP, etc.), and the event type is
locked to the destination. For Meta, OpenAI Ads and Reddit, `type` is absent:
pixels accept any event name per request.

For Reddit, the pixels of every ad account the connection reaches (only the scoped
ones when the connection has an ad-account scope), each with the `adAccountId` that owns
it. Reddit pixels are created in Reddit Ads Manager, not through Zernio.

For LinkedIn, destinations are returned across every sponsored ad
account the connected token can access; the `adAccountId` field on
each destination identifies the parent ad account and is required for
subsequent CRUD calls (update, delete, associations, metrics).

## Query parameters

- `accountId` string, required

## Response `200`

Destinations listed

- object
  - `platform` 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads' | 'pinterestads' | 'redditads'
  - `destinations` object[]
    - `id` string: Destination identifier. Meta: pixel ID. Google: conversion action resource name. LinkedIn: numeric conversion rule ID. OpenAI Ads: pixel wire id. Reddit: pixel id (`a2_...`).
    - `name` string
    - `type` string: Present when the platform locks event type to the destination (Google conversion actions, LinkedIn conversion rules).
    - `status` 'active' | 'inactive'
    - `adAccountId` string: Set by adapters whose destinations are scoped to a specific ad account (LinkedIn, Reddit). On LinkedIn, pass it back on subsequent CRUD calls.
    - `conversionEvents` object[]: OpenAI Ads only: the conversion event settings wired to this pixel. Pass one's `id`, `eventType` or `name` as `promotedObject.customEventType` on a `goal: conversions` create (POST /v1/ads/create or POST /v1/ads/campaigns) to optimize for it. Without it, the account's most recently created `optimizable` event is used; when none is, the create returns 400.
      - `id` string
      - `name` string
      - `eventType` string, nullable: OpenAI event type, e.g. order_created, lead_created, or custom.
      - `customEventName` string, nullable
      - `archived` boolean
      - `optimizable` boolean: Active and standard (not custom). Only these can be a conversions campaign's optimization event.

## Other responses

- `400`: Account's platform is not supported by the Conversions API.
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: Ads access required (Ads add-on on legacy plans, included on usage-based plans), OR (for LinkedIn) the connected account lacks the `rw_conversions` scope and must be reconnected.
- `404`: The account or requested resource was not found or is not accessible. An account ID may have been disconnected and removed. Read GET /v1/accounts for current account IDs.
- `409`: The account exists but is inactive or needs reconnection. Reconnect it, then read GET /v1/accounts for its current account ID before retrying. Code: ads_connection_required.
- `429`: LinkedIn rate limit hit. Retry with backoff.

## Changes

- **2026-11-11** `34f8dbff5e0d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/conversions/destinations/get.md)

---

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