After uploading a statement, use this endpoint to check the status of staging and processing.
Get Statement Processes
Returns the staging and processing status for a specific statement.
Request
GET /v1/statements/{statement_id}/processes
Path Parameters
| Parameter | Type | Required | Description |
|---|
statement_id | integer | Yes | The staging or statement ID |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|
projectId | UUID | Yes | — | The project the statement belongs to |
| Header | Required | Description |
|---|
Authorization | Yes | Bearer <token> — must be scoped to the requested project |
Response
| Field | Type | Description |
|---|
staging_id | integer | The staging record identifier |
statement_id | integer | The statement ID (available after staging completes) |
staging_done | boolean | Whether staging (pre-processing) has completed |
processing_done | boolean | Whether statement processing has completed |
staging_processes | object | Staging stage and info |
staging_processes.stage | string | Current staging stage (queued, completed, failed) |
staging_processes.info | object | Staging details |
processing_processes | object | Processing status (null until staging completes) |
processing_processes.status | string | Current processing status (processing, completed, failed) |
processing_processes.stage | integer | Current processing stage number |
processing_processes.remarks | object | Processing remarks and details |
{
"data": {
"staging_id": 456,
"statement_id": 1234,
"staging_done": true,
"processing_done": false,
"staging_processes": {
"stage": "completed",
"info": {}
},
"processing_processes": {
"status": "processing",
"stage": 2,
"remarks": {}
}
}
}
You can pass either the staging ID (returned from upload) or the statement ID. The endpoint resolves both. statement_id and processing_processes are null until staging completes successfully.
Errors
| Status | Description |
|---|
400 | Missing or invalid projectId |
403 | Token is not scoped to the requested project |
404 | Statement not found |
429 | Rate limit exceeded |
Example
curl "https://api.royaltyport.com/v1/statements/456/processes?projectId=a1b2c3d4-..." \
-H "Authorization: Bearer rp_your_token_here"
