Get a bulk job

​

Returns the current state of one of your bulk import or export jobs — status, row counts, progress, and, once the job has completed, the download links.

downloadUrl (exports) and errorReportUrl (imports with failed rows) are temporary links: each one stops working 15 minutes after this response. Fetch the job again for fresh links. The files themselves are kept until the job's expiresAt, 7 days after completion.

Requires the inventory:read scope.

Path Parameters
  • jobId
    Type: string
    min length:  
    1
    required

    The job's identifier, returned by POST /v1/inventory/bulk/import or POST /v1/inventory/bulk/export. Path parameter.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/inventory/bulk/jobs/{jobId}
curl 'https://public-api.cardnexus.com/v1/inventory/bulk/jobs/{jobId}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "job": {
    "id": "6848a1b2c8d4e9f7a6b5c4d3",
    "kind": "export",
    "status": "completed",
    "format": "csv",
    "mode": null,
    "counts": {
      "total": 1842,
      "succeeded": 1842,
      "failed": 0
    },
    "progress": 100,
    "errorMessage": null,
    "downloadUrl": "https://cardnexus-files.s3.eu-west-1.amazonaws.com/inventory-bulk-jobs/665f3a2b1c8d4e9f7a6b5c4d/6848a1b2c8d4e9f7a6b5c4d3/inventory-export.csv.gz?X-Amz-Expires=900&X-Amz-Signature=b27c...",
    "errorReportUrl": null,
    "expiresAt": "2026-06-17T09:15:31.000Z",
    "createdAt": "2026-06-10T09:14:02.000Z"
  }
}

Bulk job returned.