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

# POST /ListIngestConfigurations

`POST /ListIngestConfigurations`

Lists all IngestConfigurations in your account, in the AWS region where the API request is processed.

## Request body

- object
  - `filterByStageArn` string — Filters the response list to match the specified stage ARN. Only one filter (by stage ARN or by state) can be used at a time.
  - `filterByState` 'ACTIVE' | 'INACTIVE' — Filters the response list to match the specified state. Only one filter (by stage ARN or by state) can be used at a time.
  - `nextToken` string — The first IngestConfiguration to retrieve. This is used for pagination; see the <code>nextToken</code> response field.
  - `maxResults` integer — Maximum number of results to return. Default: 50.

## Response `200`

Success

- ListIngestConfigurationsResponse
  - `ingestConfigurations` IngestConfigurationSummary[], required — List of the matching ingest configurations (summary information only).
    - `name` string — Ingest name.
    - `arn` string, required — Ingest configuration ARN.
    - `ingestProtocol` 'RTMP' | 'RTMPS', required — Type of ingest protocol that the user employs for broadcasting.
    - `stageArn` string, required — ARN of the stage with which the IngestConfiguration is associated.
    - `participantId` string, required — ID of the participant within the stage.
    - `state` 'ACTIVE' | 'INACTIVE', required — State of the ingest configuration. It is <code>ACTIVE</code> if a publisher currently is publishing to the stage associated with the ingest configuration.
    - `userId` string — Customer-assigned name to help identify the participant using the IngestConfiguration; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.</i>
    - `redundantIngest` boolean — Indicates whether redundant ingest is enabled for the ingest configuration.
  - `nextToken` string — If there are more IngestConfigurations than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException

---

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