Contacts

Download Contact Export

Download a finished contact export (302 redirect to a signed URL).

Required Scopes: contacts:export

Only the requesting tenant's own COMPLETED export jobs can be downloaded (404 unknown job, 403 foreign tenant, 409 not finished yet). A fresh short-lived (60 min) signed Cloud Storage URL is minted on every call. With ?redirect=false the signed URL is returned as JSON {"download_url": ..., "filename": ...} instead of a 302.

get/api/v1/contacts/export/{job_id}/download

Request

  • Base URL: https://api.sendseven.com
  • URL: https://api.sendseven.com/api/v1/contacts/export/{job_id}/download
  • Auth: HTTP bearer

Path parameters

job_idstring required

Query parameters

redirectboolean

true (default): 302 redirect to the signed URL. false: return {download_url, filename} JSON instead — needed by browser SPAs whose auth is Bearer-header-only (a top-level navigation cannot carry the header, and an XHR cannot follow the 302 to Cloud Storage because the bucket has no CORS rule).

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.