Get export status

GET

/api/v1/leads/exports/{id}

• Production

Cost: Free

Try it

curl https://app.leadsonar.io/api/v1/leads/exports/4fad85cd-3e37-4797-ab77-07ed02d8f408 \
  -H "X-API-Key: $LS_KEY"

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

Job state

object

id

string format: uuid

status

string

Allowed values: queued running completed failed

requestedLimit

integer

progress

integer

deliveredRows

Rows actually delivered and billed. Leads this account already revealed are skipped and not charged again, so a repeat of the same filters returns fewer rows — 0 once the segment is exhausted.

integer

creditsCharged

integer

capped

boolean

filename

string

note

string

nullable

downloadable

boolean

createdAt

string format: date-time

completedAt

string format: date-time

nullable

Example

{
  "id": "4fad85cd-3e37-4797-ab77-07ed02d8f408",
  "status": "completed",
  "requestedLimit": 3,
  "progress": 100,
  "deliveredRows": 3,
  "creditsCharged": 3,
  "capped": true,
  "filename": "leadsonar-export-2026-10-06-3.csv",
  "note": null,
  "downloadable": true,
  "createdAt": "2026-10-06T10:27:26.534Z",
  "completedAt": "2026-10-06T10:27:27.463Z"
}

404

Unknown export on this account (EXPORT_NOT_FOUND)

object

error

required

Human-readable error message

string

message

Additional details

string

Example

{"error": "Unknown export", "code": "EXPORT_NOT_FOUND"}