---
title: "List Pixel Bundles"
method: GET
path: "/pixel_bundles"
tags: ["Pixel Bundles"]
---

# List Pixel Bundles

`GET /pixel_bundles`

## Request

- Base URL: `https://api.mediamath.com/api/v3.0`
- URL: `https://api.mediamath.com/api/v3.0/pixel_bundles`
- Auth: OAuth 2
  - Authorization code: `https://auth.mediamath.com/authorize`
  - Token URL: `https://auth.mediamath.com/oauth/token` scopes: `offline_access`, `manage:services`
- TypeScript: <https://skmtc.dev/mediamath/apis/campaigns-api/docs/pixel_bundles/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of pixel bundles

## Query parameters

- `page_limit` integer
- `page_offset` integer
- `sort_by` string
- `q` string
- `with` 'organization'
- `full` string

## Response `200`

Pixel bundles response

- union
  - PixelBundleCollection
    - `data` object[], nullable
      - `id` integer
      - `name` string
      - `entity_type` string
    - `meta` ListMetadata
      - `status` string, required: The status of the response, indicating success or failure.
      - `count` integer, required: The number of items returned in the current response.
      - `total_count` integer: The total number of items available in the dataset.
      - `offset` integer: The offset from the start of the dataset, used for pagination.
      - `next_page` string: The URL to fetch the next page of results.
      - `prev_page` string: The URL to fetch the previous page of results.
  - PixelBundleCollectionFull
    - `data` PixelBundleResponse
      - `pixel_type` 'creative' | 'event' | 'data' | 'segment' | 'dynamic'
      - `advertiser_id` integer, nullable
      - `agency_id` integer, nullable
      - `id` integer
      - `provider_id` integer, nullable
      - `name` string
      - `cost_pct_cpm` number, nullable
      - `eligible` boolean
      - `tags` string, nullable
      - `cost_cpm` number, nullable
      - `external_identifier` string
      - `tag_type` 'dfa' | 'uat' | 'image' | 'iframe' | 'js'
      - `pricing` 'CPM' | 'CPTS', nullable
      - `cost_cpts` number, nullable
      - `segment_op` 'AND' | 'OR', nullable
      - `rmx_friendly` boolean
      - `rmx_merit` boolean
      - `rmx_pc_window_minutes` integer, nullable
      - `rmx_pv_window_minutes` integer, nullable
      - `rmx_conversion_type` 'one' | 'variable'
      - `rmx_conversion_minutes` integer
      - `currency` 'S1' | 'S2' | 'V1' | 'V2', nullable
      - `revenue` 'S1' | 'S2' | 'V1' | 'V2', nullable
      - `currency_fixed` string, nullable
      - `status` boolean
      - `event_urls` string[], nullable
      - `container_tags` string[], nullable
      - `version` integer
    - `meta` ListMetadata
      - `status` string, required: The status of the response, indicating success or failure.
      - `count` integer, required: The number of items returned in the current response.
      - `total_count` integer: The total number of items available in the dataset.
      - `offset` integer: The offset from the start of the dataset, used for pagination.
      - `next_page` string: The URL to fetch the next page of results.
      - `prev_page` string: The URL to fetch the previous page of results.

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response

---

[API](https://skmtc.dev/mediamath/apis/campaigns-api.md) - [All operations](https://skmtc.dev/mediamath/apis/campaigns-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mediamath/apis/campaigns-api/revisions/408743891def?raw)