---
title: "List Audience Segment Taxonomies"
method: GET
path: "/audience_taxonomies"
tags: ["Targeting"]
---

# List Audience Segment Taxonomies

`GET /audience_taxonomies`

## Request

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

Returns a paginated list of audience segment taxonomies. By default each item
contains only the root node of its taxonomy (`taxonomy.children` is an empty
array); pass `full=true` (or `full=1` / `full=*`) to also return the complete
nested segment tree under each root. Results can be filtered with `q=` and
sorted with `sort_by=`.

**Filterable / sortable fields:**
| Field | Source table |
|---|---|
| `id` | audience_segments |
| `taxonomy_id` | audience_segments |
| `audience_vendor_id` | audience_segments |
| `name` | audience_segments |
| `code` | audience_segments |
| `buyable` | audience_segments |
| `retail_cpm` | audience_segments |
| `wholesale_cpm` | audience_segments |
| `uniques` | audience_segments |
| `visibility` | audience_taxonomies |

Pagination is at the **taxonomy** level: `page_limit=1` returns one taxonomy
(with its complete tree when `full` is set, potentially many segments).
Filtering on segment fields (for example `q=name=:*X*`) still selects taxonomies
that contain a matching segment, regardless of `full`.

## Query parameters

- `page_limit` integer
- `page_offset` integer
- `sort_by` string
- `q` string
- `full` string

## Response `200`

Paginated list of audience segment taxonomies

- AudienceTaxonomiesCollectionResponse
  - `data` AudienceTaxonomiesCollectionItem[]: List of audience segment taxonomy items for the current page
    - `taxonomy_id` integer, required: ID of the audience_taxonomies row
    - `created_by` integer, nullable, required: ID of the user who created the taxonomy (audience_taxonomies.created_by)
    - `updated_by` integer, nullable, required: ID of the user who last updated the taxonomy (audience_taxonomies.updated_by)
    - `created_on` string, date-time, nullable, required: Timestamp when the taxonomy was created (audience_taxonomies.created_on)
    - `updated_on` string, date-time, nullable, required: Timestamp when the taxonomy was last updated (audience_taxonomies.updated_on)
    - `audience_vendor_id` integer, required: ID of the audience_vendors row associated with this taxonomy
    - `vendor_id` integer, required: ID of the underlying vendor owning this taxonomy
    - `revenue_share_pct` number, double, nullable: Revenue share percentage
    - `visibility` 'GLOBAL' | 'RESTRICTED', required: Visibility scope of the taxonomy
    - `permissions` object: Entity-scoped access permissions. Included only when the caller is authorized to view permissions for this taxonomy.
      - `organizations` integer[], required
      - `agencies` integer[], required
      - `advertisers` integer[], required
    - `taxonomy` AudienceTaxonomiesCollectionNodeResponse, required
      - `id` integer, required: ID of the audience_segments row for this node
      - `name` string, required: Display name of this segment node
      - `code` string, nullable: Vendor-defined segment code (raw or CRC32-hashed)
      - `buyable` boolean, required: Whether this segment can be purchased/targeted
      - `retail_cpm` number, double, nullable: Retail cost per thousand impressions
      - `wholesale_cpm` number, double, nullable: Wholesale cost per thousand impressions
      - `uniques` integer, nullable: Estimated number of unique users in this segment
      - `children` AudienceTaxonomiesCollectionNodeResponse[], required: Nested child segment nodes (may be empty)
  - `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
- `500`: 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)