# Get Permission List

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-taxonomy](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-audience-taxonomy)
This will retrieve [entity](https://apidocs.mediamath.com/campaigns/api-reference#entity-heirarchy) IDs in the MediaMath Platform (organizations, agencies and/or advertisers) to which you, as a data provider, have access. To identify entity IDs for your customers and request your grants be updated, reach out to [MediaMath Support](http://support.mediamath.com) or ask your client to locate their relevants IDs within the MediaMath Platform Admin section.

Endpoint: GET /audience_segments/grants/{vendor_id}
Version: 2.0
Security: OAuth2

## Security:

  - `OAuth2` (unknown)
    oauth2

## Path parameters:

  - `vendor_id` (string, required)
    Your vendor ID, provided by MediaMath partnerships team.

## Response 200 fields (application/json):

  - `meta` (object)

  - `meta.status` (string)

  - `data` (object)

  - `data.organizations` (array)

  - `data.organizations.name` (string)

  - `data.organizations.id` (integer)

  - `data.agencies` (array)

  - `data.agencies.name` (string)

  - `data.agencies.id` (integer)

  - `data.advertisers` (array)

  - `data.advertisers.name` (string)

  - `data.advertisers.id` (integer)

## Response 200 examples:

  - `response` (unknown)