Skip to main content
GET
Download an export

Authorizations

x-conveyour-token
string
header
required

Your API key token. Contacts endpoints require a Server-only — Full API key — see Authentication.

Path Parameters

id
string
required

The export's ID.

Query Parameters

teams[]
string[]

Team scope for the request, as one or more team ObjectIds. The brackets are required: PHP keeps only the last value for a repeated plain key, so teams=A&teams=B silently resolves to B alone. On requests with a JSON body you may send teams (no brackets) in the body instead.

Values that are not valid ObjectIds are silently ignored — a mistyped team ID behaves as if no team was sent. See the teams section of the API conventions guide.

Response

Redirect to a pre-signed download URL. There is no JSON body on success. Follow the Location header to fetch the bundle.

The Location URL is a pre-signed S3 (DigitalOcean Spaces) link valid for 1 hour. It serves the stored bundle with Content-Disposition: attachment and a filename derived from the export's name; the extension comes from the stored bundle_path (falling back to .bin). Follow the redirect with a plain GET — do not send the x-conveyour-token header to the S3 host.