API Docs / Schemas / CsvExportJobDto

CsvExportJobDto

Represents the current status and progress of a CSV export job.
Returned when starting an export or polling for status.
Use this to track progress and obtain the download URL when complete.

Properties

Name Type Description
codestring

Unique code identifying this export job.
Use this code to poll for status via GET /clients/export/csv/{code}.

Unique code identifying this export job.
Use this code to poll for status via GET /clients/export/csv/{code}.

statusenum

Queued InProgress Completed Failed Cancelled

Queued InProgress Completed Failed Cancelled

totalItemsinteger

Total number of clients to export.
Set when the export job starts processing.

Total number of clients to export.
Set when the export job starts processing.

processedItemsinteger

Number of clients that have been written to the CSV so far.
Compare with TotalItems to calculate progress percentage.

Number of clients that have been written to the CSV so far.
Compare with TotalItems to calculate progress percentage.

downloadUrlstring

URL to download the generated CSV file.
Only available when Status is Completed.
This is a time-limited SAS URL that expires after the export job's expiry date.

URL to download the generated CSV file.
Only available when Status is Completed.
This is a time-limited SAS URL that expires after the export job's expiry date.

startedDatestring

When the job started processing (UTC).
Null if the job hasn't started yet (status is Queued).

When the job started processing (UTC).
Null if the job hasn't started yet (status is Queued).

completedDatestring

When the job completed processing (UTC).
Null if the job hasn't completed yet (status is Queued or InProgress).
Set for both successful completion and failure.

When the job completed processing (UTC).
Null if the job hasn't completed yet (status is Queued or InProgress).
Set for both successful completion and failure.

createdDatestring

When the export job was created (UTC).

When the export job was created (UTC).

JSON Example

{
  "code": "string",
  "status": "Queued",
  "totalItems": 150,
  "processedItems": 75,
  "downloadUrl": "string"
}

Used By Operations