---
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

---

[API](https://skmtc.net/stainless-api/apis/grid-api.md) · [All operations](https://skmtc.net/stainless-api/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stainless-api/grid-api/revisions/27ff0fdca01c/schema)
