---
title: "GET /consents"
method: GET
path: "/consents"
tags: ["Consent"]
---

# GET /consents

`GET /consents`

Gets a list of consents for the authenticated Speech service resource.

## Query parameters

- `skip` integer
- `maxpagesize` integer
- `filter` string
- `api-version` string, required

## Response `200`

Success

- PaginatedConsents — Paginated consent list
  - `value` Consent[], required — Consent list
    - `id` string — Resource id
    - `displayName` string — Name of consent.
    - `description` string — Description of consent.
    - `voiceTalentName` string, required — Voice talent name. Must match the voice talent name in the consent audio file.
    - `companyName` string, required — Company name. Must match the company name in the consent audio file.
    - `audioUrl` string, uri — The public accessible URL of the consent audio file. It's recommended to be an Azure blob URL with [SAS](https://learn.microsoft.com/azure/storage/common/storage-sas-overview). This property is only available in request.
    - `locale` string, required — The locale of this consent. Locale code follows BCP-47. You can find the text to speech locale list here https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
    - `projectId` string, required — Resource id
    - `properties` ConsentProperties — Consent properties
      - `failureReason` 'AudioAndScriptNotMatch' | 'Internal' — Consent creation failure reason
    - `status` 'NotStarted' | 'Running' | 'Succeeded' | 'Failed' | 'Disabling' | 'Disabled' — Status of a resource.
    - `createdDateTime` string, date-time — The timestamp when the object was created. The timestamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations)
    - `lastActionDateTime` string, date-time — The timestamp when the current status was entered. The timestamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
  - `nextLink` string, uri — Link to next page.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-speech-texttospeech.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-speech-texttospeech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-speech-texttospeech/versions/ab0685f3cc0d/schema)