> ## 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 statements status

> Check processing status for a statement.

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

Checks the staging and processing status for a previously uploaded statement.

***

## Arguments

| Argument     | Required | Description                                  |
| ------------ | -------- | -------------------------------------------- |
| `project_id` | Yes      | The project UUID                             |
| `staging_id` | Yes      | Staging ID returned from `statements 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 processing 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                               |
| **Statement ID**    | The statement ID (available after staging completes) |
| **Staging**         | Current staging stage (color-coded)                  |
| **Staging Done**    | Whether staging has completed                        |
| **Processing Done** | Whether processing has completed                     |

***

## Examples

Check status once:

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

Watch until processing completes:

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