royaltyport statements upload

royaltyport statements upload <project_id> [file_path]

Uploads a statement file to a project for processing. You can provide either a local file path or base64-encoded content.

Arguments

Argument	Required	Description
`project_id`	Yes	The project UUID
`file_path`	No	Path to the statement file

Option	Short	Description
`--base64 <string>`	—	Base64-encoded file content (alternative to file_path)
`--file-name <name>`	—	File name (required with `--base64`)

You must provide either file_path or --base64, but not both
When using --base64, --file-name is required
On success, prints the staging ID and a hint to track progress with royaltyport statements status

Prints a table with upload details:

Field	Description
Staging ID	Unique identifier for tracking processing progress
Staging Stage	Current processing stage (`queued`, `processing`, `completed`, `failed`)
Staging Done	Whether staging (pre-processing) has completed
Processing Done	Whether statement processing has completed
Created At	Upload timestamp

Upload a local file:

royaltyport statements upload a1b2c3d4-e5f6-7890-abcd-ef1234567890 ./Q1-2025-royalties.xlsx

Upload base64-encoded content:

royaltyport statements upload a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  --base64 "UEsDBBQAAAAI..." \
  --file-name "Q1-2025-royalties.xlsx"