# Audience Segments API

{% admonition type="danger" name="This API is deprecated as of 1st August 2026" %}
The functionality has been built into the V3 Campaign Management API docs which can be found here: [https://apidocs.mediamath.com/apis/campaigns-api/openapi](https://apidocs.mediamath.com/apis/campaigns-api/openapi)
{% /admonition %}

Version: 2.0
License: Apache 2.0

## Servers

```
https://api.mediamath.com/dmp/v2.0
```

## Security

### OAuth2

Type: oauth2
Token URL: https://auth.mediamath.com/oauth/token
Scopes:

### Cookie_Auth

Cookie: adama_sesion=`cookie-id`. Security: API Key - Please note that adama_cookie support is being deprecated and will be removed in our future v2 API.

Type: apiKey
In: header
Name: Cookie

## Download OpenAPI description

 - [Audience Segments API](https://apidocs.mediamath.com/_bundle/apis/audience-taxonomies.yaml)

## Permission Taxonomies - Deprecated

 - [POST /audience_segments](https://apidocs.mediamath.com/apis/audience-taxonomies/permission-taxonomies-deprecated/post_audience_segments.md): The functionality has been built into the V3 Campaign Management API, equivalent v3 endpoint can be found here: [https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/post-audience-taxono
 - [GET /audience_segments](https://apidocs.mediamath.com/apis/audience-taxonomies/permission-taxonomies-deprecated/get_audience_segments.md): The functionality has been built into the V3 Campaign Management API, equivalent v3 endpoint can be found here: [https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-audience-taxonom
 - [GET /audience_segments/grants/{vendor_id}](https://apidocs.mediamath.com/apis/audience-taxonomies/permission-taxonomies-deprecated/get_audience_segments-grants-$vendor_org_id.md): The functionality has been built into the V3 Campaign Management API, equivalent v3 endpoint can be found here: [https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-audience-taxonom
 - [GET /audience_segments/{taxonomy_id}](https://apidocs.mediamath.com/apis/audience-taxonomies/permission-taxonomies-deprecated/get_audience_segments-taxonomy_id.md): The functionality has been built into the V3 Campaign Management API docs which can be found here: [https://apidocs.mediamath.com/apis/campaigns-api/openapi](https://apidocs.mediamath.com/apis/campaig
 - [POST /audience_segments/{taxonomy_id}](https://apidocs.mediamath.com/apis/audience-taxonomies/permission-taxonomies-deprecated/post_audience_segments-taxonomy_id.md): The functionality has been built into the V3 Campaign Management API, equivalent v3 endpoint can be found here: [https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/post-audience-taxono