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 <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:
royaltyport contracts status a1b2c3d4-e5f6-7890-abcd-ef1234567890 stg_abc123
Watch until processing completes:
royaltyport contracts status a1b2c3d4-e5f6-7890-abcd-ef1234567890 stg_abc123 --watch