---
title: "POST /ListRecordingConfigurations"
method: POST
path: "/ListRecordingConfigurations"
---

# POST /ListRecordingConfigurations

`POST /ListRecordingConfigurations`

Gets summary information about all recording configurations in your account, in the Amazon Web Services region where the API request is processed.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `maxResults` integer — Maximum number of recording configurations to return. Default: your service quota or 100, whichever is smaller.
  - `nextToken` string — The first recording configuration to retrieve. This is used for pagination; see the <code>nextToken</code> response field.

## Response `200`

Success

- ListRecordingConfigurationsResponse
  - `nextToken` string — If there are more recording configurations than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.
  - `recordingConfigurations` RecordingConfigurationSummary[], required — List of the matching recording configurations.
    - `arn` string, required — Recording-configuration ARN.
    - `destinationConfiguration` object, required — A complex type that contains information about where recorded video will be stored.
      - `s3` object — An S3 destination configuration where recorded videos will be stored.
        - `bucketName` string, required — Location (S3 bucket name) where recorded videos will be stored.
    - `name` string — Recording-configuration name. The value does not need to be unique.
    - `state` 'CREATING' | 'CREATE_FAILED' | 'ACTIVE', required — Indicates the current state of the recording configuration. When the state is <code>ACTIVE</code>, the configuration is ready for recording a channel stream.
    - `tags` object — Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no service-specific constraints beyond what is documented there.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ValidationException

---

[API](https://skmtc.net/aws/apis/ivs.md) · [All operations](https://skmtc.net/aws/apis/ivs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/ivs/versions/32a77504a115/schema)