Statement Download

Download Statement

Returns a signed download URL for a statement’s original file. The URL expires in 1 hour.

Request

GET /v1/statements/{statement_id}/download

Path Parameters

Parameter	Type	Required	Description
`statement_id`	integer	Yes	The statement ID

Query Parameters

Parameter	Type	Required	Default	Description
`projectId`	UUID	Yes	—	The project the statement belongs to

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <token>` — must be scoped to the requested project

Response

{
  "data": {
    "url": "https://storage.example.com/statements/Q1-2025-royalties.xlsx?token=...",
    "fileName": "Q1-2025-royalties.xlsx",
    "fileType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    "expiresIn": 3600
  }
}

Field	Type	Description
`url`	string	Pre-signed download URL
`fileName`	string	Original file name
`fileType`	string	MIME type of the file
`expiresIn`	integer	URL expiration time in seconds

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/1234/download?projectId=a1b2c3d4-..." \
  -H "Authorization: Bearer rp_your_token_here"

Getting Started

REST API

Download Statement

Request

Path Parameters

Query Parameters

Headers

Response

Errors

Example

​Download Statement

​Request

​Path Parameters

​Query Parameters

​Headers

​Response

​Errors

​Example

Download Statement

Request

Path Parameters

Query Parameters

Headers

Response

Errors

Example