> ## 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 upload

> Upload a statement file to a project.

```bash theme={null}
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 |

***

## Options

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

***

## Behavior

* 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`

***

## Output

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                                                         |

***

## Examples

Upload a local file:

```bash theme={null}
royaltyport statements upload a1b2c3d4-e5f6-7890-abcd-ef1234567890 ./Q1-2025-royalties.xlsx
```

Upload base64-encoded content:

```bash theme={null}
royaltyport statements upload a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  --base64 "UEsDBBQAAAAI..." \
  --file-name "Q1-2025-royalties.xlsx"
```