---
title: "Parse Status"
method: GET
path: "/parse/jobs/{job_id}/status"
tags: ["/parse"]
---

# Parse Status

`GET /parse/jobs/{job_id}/status`

Get the status of a parse job.

Parse job results are retained for up to 30 days after job creation. Fetching a status for a parse job that is older than 30 days will return a 404 error.

## Path parameters

- `job_id` string, uuid, required — Unique ID of the parse job

## Response `200`

Successful Response

- ParseStatusResponseV1 — /parse status reponse object.
  - `status` 'pending' | 'processing' | 'retrying' | 'completed' | 'failed' | 'cancelled', required
  - `file_name` string, required — The name of the file that was uploaded for parsing

## Other responses

- `422` — Validation Error

## Changes

- **2025-05-08** `17bdb8a33fb4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/parse/jobs/:job_id/status/get.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contextualai/endpoints/revisions/ca7f807eec8b/schema)
