Skip to main content
royaltyport contracts status <project_id> <staging_id>
Checks the staging and extraction processing status for a previously uploaded contract.

Arguments

ArgumentRequiredDescription
project_idYesThe project UUID
staging_idYesStaging ID returned from contracts upload

Options

OptionShortDescription
--watch-wPoll 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:
FieldDescription
Staging IDThe staging identifier
Contract IDThe contract ID (available after staging completes)
StagingCurrent staging stage (color-coded)
Staging DoneWhether staging has completed
Extraction DoneWhether 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