---
title: "Get job(s) by status"
method: GET
path: "/api/v2/jobs"
tags: ["job"]
---

# Get job(s) by status

`GET /api/v2/jobs`

Returns the current statuses of all current and past export jobs, along with the original job request url. Supported status types are: 

 - Completed

 - Archived

 - Expired

 - Failed

 - FailedExpired

 - In Progress

 - Pending

 - Cancelled

 - CancelledExpired

 If no status(s) is provided, all jobs will be returned.

Note on job status to fhir task resource status mapping:
Due to the fhir task status field having a smaller set of values, the following statuses will be set to different fhir values in the response

 - Archived, Expired -> Completed

 - FailedExpired -> Failed

 - Pending -> In Progress

 - CancelledExpired -> Cancelled

Though the status name has been remapped the response will still only contain jobs pertaining to the provided job status in the request.

## Query parameters

- `_status` JobStatus[]

## Response `200`

JSON object containing statuses of all current and previously requested jobs. The body will contain a FHIR Bundle resource in JSON format https://www.hl7.org/fhir/bundle.html and FHIR Task resources for the Bundle entries in JSON format https://www.hl7.org/fhir/task.html

## Other responses

- `400` — Malformed request; check URI and parameters are correct. The body will contain a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html
- `401` — Unauthorized. The provided credentials are invalid for the requested resource. The body will contain a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html
- `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. Completed jobs expire after 24 hours; request the data again. The body will contain a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html
- `500` — An error occurred. The body will contain a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html

---

[API](https://skmtc.net/cmsgov/apis/beneficiary-claims-data-api.md) · [All operations](https://skmtc.net/cmsgov/apis/beneficiary-claims-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cmsgov/beneficiary-claims-data-api/versions/3565bdea5a5f/schema)