Export

ReferenceUpdated June 14, 2026

Export

Download the processed output for a completed list as CSV or JSON. See Lists for list status and management.

Export list results

GET /api/v1/lists/:id/export · scope lists:read

Returns the processed output for a completed list. Call this only after GET /api/v1/lists/:id shows processing_status: "completed".

Path parameters

ParameterTypeDescription
idstring (UUID)List ID.

Query parameters

ParameterTypeRequiredDescription
formatstringNocsv (default) or json.

Example request (CSV)

curl -X GET "https://app.machfive.io/api/v1/lists/LIST_ID/export?format=csv" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.csv

Example request (JSON)

curl -X GET "https://app.machfive.io/api/v1/lists/LIST_ID/export?format=json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (200 OK)

  • format=csv: Response body is the processed CSV (same columns as UI download). Use Content-Disposition if present for filename.
  • format=json: Body is a JSON object:
{
  "leads": [
    {
      "email": "jane@acme.com",
      "name": "Jane Doe",
      "company": "Acme Inc",
      "title": "VP Marketing",
      "sequence": [
        { "step": 1, "subject": "...", "body": "..." },
        { "step": 2, "subject": "...", "body": "..." }
      ]
    }
  ]
}

Error responses

StatusErrorDescription
409NOT_READYList not yet completed; poll GET /lists/:id first. detail.processing_status shows the current status.
401UNAUTHORIZEDMissing or invalid API key.
403FORBIDDENKey missing the lists:read scope.
404NOT_FOUNDList not found or not in this workspace.
500INTERNAL_ERRORExport failed or no processed file available.

Related guides