---
title: "List retargeting pixels"
method: GET
path: "/api/pixels"
tags: ["Retargeting Pixels"]
---

# List retargeting pixels

`GET /api/pixels`

## Request

- Base URL: `https://www.flyn.to`
- URL: `https://www.flyn.to/api/pixels`
- Auth: HTTP bearer

Lists saved pixels, newest first. In a team workspace: every pixel of the team, whoever created it. Otherwise: the caller's personal pixels. Each item carries `is_owner`.

**Auth:** API key (`Bearer flyn_sk_live_...`), or the signed-in dashboard session cookie when no API key header is sent. MCP OAuth access tokens are not accepted here and get 401.

**Plan:** every plan. Any team role.

**Rate limit:** none.

## Response `200`

The pixels.

- PixelList
  - `pixels` Pixel[], required
    - `id` string, uuid, required
    - `provider` 'meta' | 'google_ads' | 'ga4' | 'gtm' | 'linkedin' | 'twitter' | 'tiktok' | 'pinterest' | 'quora' | 'reddit' | 'snapchat' | 'microsoft' | 'adroll', required
    - `value` string, required: Pixel or tag id.
    - `label` string, required
    - `created_at` string, date-time, required
    - `is_owner` boolean: List responses only: true when the caller created the pixel. Only the creator can edit or delete it.

## Other responses

- `401`: No valid API key and no dashboard session. Messages: "Invalid or revoked API key", "API key has expired", "Unauthorized. Sign in to the dashboard, or pass a Bearer API key in the Authorization header.", or "Unauthorized" when the session lookup itself fails. An MCP OAuth token lands here too.
- `403`: The account is suspended.
- `500`: Database error.

---

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