Skip to main content
GET
/
customers
/
bulk
/
jobs
/
{jobId}
Get bulk import job status
curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/customers/bulk/jobs/{jobId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "jobId": "Job:019542f5-b3e7-1d02-0000-000000000006",
  "status": "PROCESSING",
  "progress": {
    "total": 5000,
    "processed": 2500,
    "successful": 2450,
    "failed": 50
  },
  "errors": [
    {
      "correlationId": "biz456",
      "error": {
        "code": "<string>",
        "message": "<string>",
        "details": {}
      }
    }
  ],
  "completedAt": "2025-08-15T14:32:00Z"
}

Authorizations

​
Authorization
string
header
required

API token authentication using format <api token id>:<api client secret>

Path Parameters

​
jobId
string
required

ID of the bulk import job to retrieve

Response

Job status retrieved successfully

​
jobId
string
required

Unique identifier for the bulk import job

Example:

"Job:019542f5-b3e7-1d02-0000-000000000006"

​
status
enum<string>
required

Current status of the job

Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
Example:

"PROCESSING"

​
progress
object
required
​
errors
object[]

Detailed error information for failed entries

​
completedAt
string<date-time>

Timestamp when the job completed (only present for COMPLETED or FAILED status)

Example:

"2025-08-15T14:32:00Z"