---
title: "Get bulk import job status"
method: GET
path: "/customers/bulk/jobs/{jobId}"
tags: ["Customers"]
---

# Get bulk import job status

`GET /customers/bulk/jobs/{jobId}`

Retrieve the current status and results of a bulk customer import job. This endpoint can be used
to track the progress of both CSV uploads.

The response includes:
- Overall job status
- Progress statistics
- Detailed error information for failed entries
- Completion timestamp when finished

## Path parameters

- `jobId` string, required

## Response `200`

Job status retrieved successfully

- BulkCustomerImportJob
  - `id` string, required — Unique identifier for the bulk import job
  - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED', required — Current status of the job
  - `progress` object, required
    - `total` integer, required — Total number of customers to process
    - `processed` integer, required — Number of customers processed so far
    - `successful` integer, required — Number of customers successfully created
    - `failed` integer, required — Number of customers that failed to create
  - `errors` BulkCustomerImportErrorEntry[] — Detailed error information for failed entries
    - `code` string — Error code
    - `message` string — Error message
    - `details` object — Additional error details
    - `correlationId` string, required — Platform customer ID or row number for the failed entry
  - `completedAt` string, date-time — Timestamp when the job completed (only present for COMPLETED or FAILED status)

## Other responses

- `401` — Unauthorized
- `404` — Job not found
- `500` — Internal service error

## Changes

- **2026-05-28** `d0bce562bffd` — 6 warning
  - added the new `REQUEST_ID_MISSING` enum value to the `code` response property for the response status `401`
  - added the new `UMA_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `WALLET_SIGNATURE_BODY_MISMATCH` enum value to the `code` response property for the response status `401`
  - added the new `WALLET_SIGNATURE_INVALID` enum value to the `code` response property for the response status `401`
  - …2 more
- **2026-03-03** `efe0d983985f` — 3 breaking, 15 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `401`
  - the response's body type/format changed from ``/`` to `object`/`` for status `404`
  - the response's body type/format changed from ``/`` to `object`/`` for status `500`
  - removed `#/components/schemas/Error401_UNAUTHORIZED, #/components/schemas/Error401_INVALID_SIGNATURE` from the response body `oneOf` list for the response status `401`
  - …14 more
- …earlier changes not shown

[Full history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/customers/bulk/jobs/:jobId/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) · [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lightsparkdev/grid-api/revisions/d0bce562bffd/schema)