Skip to main content
GET
/
campaigns
/
{campaignId}
/
export
/
{exportId}
/
status
Get Campaign Export Status
curl --request GET \
  --url https://api.lemlist.com/api/campaigns/{campaignId}/export/{exportId}/status \
  --header 'Authorization: Basic <encoded-value>'
{
  "ok": true,
  "status": {
    "_id": "axp_7guBefTBQGqFfps87",
    "id": "axp_7guBefTBQGqFfps87",
    "teamId": "tea_b4rMsi2trB42WyuWP",
    "campaignId": "cam_DqHpWfjd67n2KTj2W",
    "campaignName": "lemstage",
    "status": "done",
    "startedAt": "2025-10-27T07:53:16.267Z",
    "progressIndex": 6,
    "progressTime": 1761551597286,
    "progressLastStepDuration": 0,
    "progressType": "done",
    "progress": 0,
    "total": 0,
    "fileSize": 23654,
    "endedAt": "2025-10-27T07:53:17.286Z",
    "url": "https://api.lemlist.com/api/files/exports/fil_axp_7guBefhehehe.csv"
  }
}
This endpoint checks the status of an asynchronous campaign export initiated with the Start Campaign Stats Export endpoint.

​
Status values

The status field in the response can be:
  • pending: The export is still being processed
  • done: The export is complete and ready to download
  • error: An error occurred during the export

​
Expiration times

  • Status availability: Export statuses are available for 2 hours only. An export still pending after 2 hours will be considered failed and return a 404 error.
  • File availability: Once you obtain the CSV file URL, you must download it within 24 hours. After that, the file will be deleted.

​
Polling strategy

Check the status periodically until you receive a status other than "pending". We recommend:
  • Starting with a 5-second interval
  • Increasing to 10-15 seconds for longer exports
  • Stopping immediately when status is "done" or "error"

​
Download URL

When the status is "done", the response will include a url field containing the download link for the CSV file.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

​
campaignId
string
required

The unique identifier of the campaign that was exported

​
exportId
string
required

The unique identifier of the export returned by the /start endpoint

Response

Export status retrieved successfully

​
ok
boolean
​
status
object