---
title: "Get project processing status"
method: GET
path: "/projects/{project_id}/status/"
tags: ["Projects"]
---

# Get project processing status

`GET /projects/{project_id}/status/`

## Request

- Base URL: `https://api.parsewise.ai/api/v1`
- URL: `https://api.parsewise.ai/api/v1/projects/{project_id}/status/`
- Auth: API key in header `X-API-Key`

Compact processing status for a project, intended for frequent
polling (for example, every 5 seconds) while documents are being
parsed or agents are running.

## Path parameters

- `project_id` string, uuid, required

## Response `200`

- V1ProjectStatusResponse
  - `parsing_state` 'ready' | 'parsing' | 'not_started' | 'stuck', required: * `ready` - ready * `parsing` - parsing * `not_started` - not_started * `stuck` - stuck
  - `pending_documents` string[], required: IDs of documents that are still being parsed.
  - `document_progress` object, required: Processing percentage keyed by pending document ID. Page parsing advances from 0 to 80; documents remain at 80 while summary and metadata are generated, then leave this map when complete.
  - `pipeline_running` boolean, required: True while the project's agent extraction pipeline is currently running.
  - `schema_status` union, required: Status of the output mapping generation for the project's target schema. Null when no schema is configured. * `pending` - pending * `success` - success * `failed` - failed
    - 'pending' | 'success' | 'failed': * `pending` - pending * `success` - success * `failed` - failed
    - unknown

---

[API](https://skmtc.dev/parsewise/apis/parsewise-api.md) - [All operations](https://skmtc.dev/parsewise/apis/parsewise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/parsewise/apis/parsewise-api/revisions/5db46512debf?raw)