> ## Documentation Index
> Fetch the complete documentation index at: https://docs.royaltyport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# royaltyport contracts status

> Check processing status for a contract.

```bash theme={null}
royaltyport contracts status <project_id> <staging_id>
```

Checks the staging and extraction processing status for a previously uploaded contract.

***

## Arguments

| Argument     | Required | Description                                 |
| ------------ | -------- | ------------------------------------------- |
| `project_id` | Yes      | The project UUID                            |
| `staging_id` | Yes      | Staging ID returned from `contracts upload` |

***

## Options

| Option    | Short | Description                                     |
| --------- | ----- | ----------------------------------------------- |
| `--watch` | `-w`  | Poll for updates until all processing completes |

***

## Behavior

* Without `--watch`: fetches and prints the current status once
* With `--watch`: polls every 3 seconds, showing a live spinner with progress, and exits when both staging and extraction are complete
* If staging failed, the error type and message are displayed

***

## Output

Prints a status line with:

| Field               | Description                                         |
| ------------------- | --------------------------------------------------- |
| **Staging ID**      | The staging identifier                              |
| **Contract ID**     | The contract ID (available after staging completes) |
| **Staging**         | Current staging stage (color-coded)                 |
| **Staging Done**    | Whether staging has completed                       |
| **Extraction Done** | Whether extraction has completed                    |

When extraction has started, a table of extraction steps is shown with their name, status, and completion time.

***

## Examples

Check status once:

```bash theme={null}
royaltyport contracts status a1b2c3d4-e5f6-7890-abcd-ef1234567890 stg_abc123
```

Watch until processing completes:

```bash theme={null}
royaltyport contracts status a1b2c3d4-e5f6-7890-abcd-ef1234567890 stg_abc123 --watch
```