---
title: "Download export file"
method: POST
path: "/contacts/exports/{id}/download"
tags: ["Contacts"]
---

# Download export file

`POST /contacts/exports/{id}/download`

## Request

- Base URL: `https://api.surense.com/api/v1`
- URL: `https://api.surense.com/api/v1/contacts/exports/{id}/download`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.surense.com/oauth/token` scopes: `global:export`

Export contacts in a 3-stage process:

(1) Filter and choose which contacts to export using `POST /contacts/exports` - works like `POST /contacts/search` with filtering, returns the UUID of the export record.

(2) Check export status using `GET /contacts/exports/{id}` - status can be `INITIATED`, `PROCESSING`, `PROCESSED`, or `FAILED`.

(3) Download the file using `POST /contacts/exports/{id}/download` - returns the URL of the file in the `url` field that can be fetched using a simple HTTP GET request.

**This is Stage 3 of 3: Download the file.**

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- DownloadExportResponse
  - `fileName` string
  - `contentType` string
  - `url` string

---

[API](https://skmtc.dev/surense/apis/contact-api.md) - [All operations](https://skmtc.dev/surense/apis/contact-api/llms.txt) - [OpenAPI document](https://skmtc.dev/surense/apis/contact-api/revisions/bbbc5c0f879a?raw)