---
title: "List Vendors"
method: GET
path: "/vendors"
tags: ["Vendors"]
---

# List Vendors

`GET /vendors`

## Request

- Base URL: `https://api.mediamath.com/api/v3.0`
- URL: `https://api.mediamath.com/api/v3.0/vendors`
- 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/vendors/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of vendors. The data fetched for each vendor depends on the values of query params. For example, if you use query parameter `full` all properties are fetched.

## Query parameters

- `page_limit` integer
- `page_offset` integer
- `sort_by` string
- `q` string
- `full` string
- `detect_domains` '1' | 'true'

## Response `200`

List vendors response

- union
  - VendorCollection
    - `data` object[]
      - `id` integer
      - `name` 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.
  - VendorCollectionFull
    - `data` VendorBase[]
      - `id` integer
      - `version` integer
      - `name` string
      - `adx_approved` boolean
      - `adx_declaration_required` boolean
      - `adx_vendor_identifier` string
      - `mm_contract_available` boolean
      - `rate_card_price` number, double
      - `rate_card_type` 'CPM' | 'FIXED'
      - `wholesale_price` number, double
      - `is_eligible` boolean
      - `created_on` string, date-time, nullable
      - `updated_on` string, date-time, nullable
      - `description` string
      - `vendor_type` 'AD_SERVER' | 'AD_VERIFICATION' | 'AUDIENCE_VERIFICATION' | 'CONTEXTUAL' | 'DATA' | 'DSP' | 'DYNAMIC_CREATIVE' | 'MEASUREMENT' | 'NETWORK' | 'OBA_COMPLIANCE' | 'OTHER' | 'PIXEL_TRACKING' | 'RICH_MEDIA' | 'SURVEY' | 'VIEWABILITY' | 'VIEWABILITY_BYO_DISPLAY' | 'VIEWABILITY_BYO_VIDEO'
      - `code` string
      - `adx_ssl_approved` boolean
      - `adx_video_ssl_approved` boolean
      - `adx_video_approved` boolean
      - `auto_tag_display` boolean
      - `provider_tax` number, double
      - `set_by` 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.

## 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)