---
title: "Request a cohort export"
method: GET
path: "/api/5/cohorts/request/{cohortId}"
tags: ["Cohorts"]
---

# Request a cohort export

`GET /api/5/cohorts/request/{cohortId}`

## Request

- Base URL: `https://amplitude.com`
- URL: `https://amplitude.com/api/5/cohorts/request/{cohortId}`
- Auth: HTTP basic

Start an asynchronous cohort export and return a request ID. Poll `/api/5/cohorts/request-status/{requestId}`, then download from `/api/5/cohorts/request/{requestId}/file`.

## Path parameters

- `cohortId` string, required

## Query parameters

- `props` 0 | 1
- `propKeys` string

## Response `202`

Export request accepted, with a request ID.

- CohortExportRequest
  - `request_id` string, required
  - `cohort_id` string, required

## Other responses

- `400`: Invalid request. Check that JSON query parameters are well formed and that special characters are URL encoded.
- `401`: Missing or invalid credentials. Send HTTP Basic auth with the project API key as the username and the secret key as the password.
- `429`: Concurrent or hourly rate limit exceeded for the project. The response identifies which limit was hit. Up to 5 concurrent requests are allowed across Amplitude REST endpoints.

## Changes

- **2026-10-14** `e475ad97669a`: 1 breaking, 4 info
  - removed the success response with the status `200`
  - added the media type `*/*` for the response with the status `400`
  - added the media type `*/*` for the response with the status `401`
  - added the media type `*/*` for the response with the status `429`
  - …1 more

[Operation history](https://skmtc.dev/amplitude/apis/amplitude-public-apis/changes/api/5/cohorts/request/:cohortId/get.md)

---

[API](https://skmtc.dev/amplitude/apis/amplitude-public-apis.md) - [All operations](https://skmtc.dev/amplitude/apis/amplitude-public-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/amplitude/apis/amplitude-public-apis/revisions/e475ad97669a?raw)