---
title: "GET /media-capture-pipelines"
method: GET
path: "/media-capture-pipelines"
---

# GET /media-capture-pipelines

`GET /media-capture-pipelines`

Returns a list of media capture pipelines.

## Query parameters

- `next-token` string
- `max-results` integer
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListMediaCapturePipelinesResponse
  - `MediaCapturePipelines` MediaCapturePipeline[] — The media capture pipeline objects in the list.
    - `MediaPipelineId` string — The ID of a media capture pipeline.
    - `SourceType` 'ChimeSdkMeeting' — Source type from which media artifacts are saved. You must use <code>ChimeMeeting</code>.
    - `SourceArn` string, password — ARN of the source from which the media artifacts will be saved.
    - `Status` 'Initializing' | 'InProgress' | 'Failed' | 'Stopping' | 'Stopped' — The status of the media capture pipeline.
    - `SinkType` 'S3Bucket' — Destination type to which the media artifacts are saved. You must use an S3 Bucket.
    - `SinkArn` string, password — ARN of the destination to which the media artifacts are saved.
    - `CreatedTimestamp` string, date-time — The time at which the capture pipeline was created, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The time at which the capture pipeline was updated, in ISO 8601 format.
    - `ChimeSdkMeetingConfiguration` object — The configuration for a specified media capture pipeline. <code>SourceType</code> must be <code>ChimeSdkMeeting</code>.
      - `SourceConfiguration` object — The source configuration for a specified media capture pipeline.
        - `SelectedVideoStreams` object — The selected video streams to capture for a specified media capture pipeline. The number of video streams can't exceed 25.
          - `AttendeeIds` GuidString[] — The attendee IDs of the streams selected for a media capture pipeline.
          - `ExternalUserIds` ExternalUserIdType[] — The external user IDs of the streams selected for a media capture pipeline.
      - `ArtifactsConfiguration` object — The configuration for the artifacts in an Amazon Chime SDK meeting.
        - `Audio` object, required — The configuration for the audio artifacts.
          - `MuxType` 'AudioOnly' | 'AudioWithActiveSpeakerVideo', required — The MUX type of the audio artifact configuration object.
        - `Video` object, required — The configuration for the video artifacts.
          - `State` 'Enabled' | 'Disabled', required — Indicates whether the video artifact is enabled or disabled.
          - `MuxType` 'VideoOnly' — The MUX type of the video artifact configuration object.
        - `Content` object, required — The configuration for the content artifacts.
          - `State` 'Enabled' | 'Disabled', required — Indicates whether the content artifact is enabled or disabled.
          - `MuxType` 'ContentOnly' — The MUX type of the artifact configuration.
  - `NextToken` string — The token used to retrieve the next page of results.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — ThrottledClientException
- `483` — UnauthorizedClientException
- `484` — ServiceUnavailableException
- `485` — ServiceFailureException

---

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