---
title: "Export engagement recipients"
method: GET
path: "/engagements/{engagementId}/recipients/export"
tags: ["Engagement"]
---

# Export engagement recipients

`GET /engagements/{engagementId}/recipients/export`

## Request

- Base URL: `https://api.gleap.io/v3`
- URL: `https://api.gleap.io/v3/engagements/{engagementId}/recipients/export`
- Auth: HTTP bearer

Export the recipients of a single engagement as CSV (`Content-Type: text/csv`, sent as an attachment
named after the engagement). Accepts the same `filter` query as the recipients list, so a filtered
view (e.g. only recipients who opened) exports exactly what is shown.

## Path parameters

- `engagementId` string, required

## Headers

- `project` string, required

## Response `200`

Ok

- unknown

## Changes

- **2026-08-21** `93af2e90fb6a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gleap/apis/gleap-server/changes/engagements/:engagementId/recipients/export/get.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) - [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) - [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/3b025e883cef?raw)
