---
title: "Get job status and file location(s)"
method: GET
path: "/api/v2/jobs/{jobId}"
tags: ["job"]
---

# Get job status and file location(s)

`GET /api/v2/jobs/{jobId}`

## Request

- The document declares no server URL.
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/cmsgov/apis/beneficiary-claims-data-api/docs/api/v2/jobs/:jobId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the current status of an export job and ndjson file locations, if available. The file locations will be under `output` and any job processing that encountered errors will be written to _<...-error.ndjson>_ files and located under `errors`.

## Path parameters

- `jobId` integer, required

## Response `200`

Data export job has completed successfully. The response body will contain a JSON object providing metadata about the transaction.

- BulkResponseBody
  - `JobID` integer
  - `error` FileItem[]: Information about error files, including URLs for downloading
    - `type` string: FHIR resource type of file contents
    - `url` string: URL of the file
  - `output` FileItem[]: Information about generated data files, including URLs for downloading
    - `type` string: FHIR resource type of file contents
    - `url` string: URL of the file
  - `request` string: URL of the bulk data export request
  - `requiresAccessToken` boolean: Indicates whether an access token is required to download generated data files
  - `transactionTime` string, date-time: Server time when the query was run

## Other responses

- `202`: Data export job is in progress.
- `400`: Malformed request. The body will contain a FHIR OperationOutcome resource in JSON format. https://www.hl7.org/fhir/operationoutcome.html Please refer to the body of the response for details.
- `401`: Unauthorized. The provided credentials are invalid for the requested resource.
- `404`: The requested path was not found. The body will contain a FHIR OperationOutcome resource in JSON format. https://www.hl7.org/fhir/operationoutcome.html
- `410`: The requested resource is no longer available. The body will contain a FHIR OperationOutcome resource in JSON format. https://www.hl7.org/fhir/operationoutcome.html

---

[API](https://skmtc.dev/cmsgov/apis/beneficiary-claims-data-api.md) - [All operations](https://skmtc.dev/cmsgov/apis/beneficiary-claims-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cmsgov/apis/beneficiary-claims-data-api/revisions/3565bdea5a5f?raw)