> ## Documentation Index
> Fetch the complete documentation index at: https://developer.uphold.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get transactions statement
> Retrieves the transactions statement for a given period.
export const RestEndpointSubjects = ({subjects = []}) => {
const subjectToIconMap = {
'client': 'browser',
'user:individual': 'user',
'user:business': 'briefcase'
};
if (subjects.length === 0) {
return null;
}
return <>
{subjects.map(subject =>
{subject}
)}
;
};
## OpenAPI
````yaml _media/specs/core-openapi.mintlify.json get /core/statements/transactions
openapi: 3.1.0
info:
version: 0.1.0
title: Core API
description: >-
The Core API provides essential building blocks that empower businesses to
embed financial services into their applications.
contact:
name: Uphold API Team
email: developers@uphold.com
url: https://developer.uphold.com
servers:
- url: https://api.enterprise.sandbox.uphold.com
description: Sandbox
- url: https://api.enterprise.uphold.com
description: Production
security:
- OAuth2: []
tags:
- name: Authentication
description: Authentication.
- name: Countries
description: Countries.
- name: Users
description: Users.
- name: KYC
description: Individual User's KYC.
- name: KYB
description: Business User's KYB.
- name: Capabilities
description: User capabilities.
- name: Terms of service
description: User terms of service.
- name: Files
description: Files.
- name: Assets
description: Assets, networks and rails.
- name: Accounts
description: Accounts.
- name: External accounts
description: External accounts.
- name: Transactions
description: Transactions.
- name: Portfolio
description: Portfolio.
- name: Statements
description: Statements.
- name: Metadata
description: Metadata.
- name: Webhooks
description: Webhooks.
paths:
/core/statements/transactions:
get:
tags:
- Statements
summary: Get transactions statement
description: Retrieves the transactions statement for a given period.
operationId: core.get-transactions-statement
parameters:
- $ref: '#/components/parameters/period'
- $ref: '#/components/parameters/year'
- $ref: '#/components/parameters/month'
- $ref: '#/components/parameters/denomination'
- $ref: '#/components/parameters/pagination-per-page'
responses:
'200':
$ref: '#/components/responses/get-transactions-statement-response'
'409':
$ref: '#/components/responses/get-transactions-statement-conflict-response'
security:
- OAuth2:
- core.statements:read
components:
parameters:
period:
name: period
description: The statement period type.
in: query
required: true
schema:
type: string
enum:
- one-month
examples:
Period:
value: one-month
year:
name: year
description: The statement year.
in: query
required: true
schema:
type: integer
format: int32
minimum: 2010
maximum: 2100
examples:
Year:
value: 2026
month:
name: month
description: The statement month.
in: query
required: true
schema:
type: integer
format: int32
minimum: 1
maximum: 12
examples:
Month:
value: 3
denomination:
name: denomination
description: >-
Specifies the asset code to use as the denomination for value
conversion. If not provided, USD is used by default.
in: query
required: false
schema:
type: string
minLength: 1
default: USD
examples:
BTC Asset:
value: BTC
pagination-per-page:
name: perPage
description: The number of items per page.
in: query
schema:
type: integer
format: int32
minimum: 1
maximum: 100
default: 10
examples:
10 Items Per Page:
value: 10
responses:
get-transactions-statement-response:
description: Transactions statement retrieved.
content:
application/json:
schema:
type: object
properties:
statement:
$ref: '#/components/schemas/transactions-statement'
pagination:
$ref: '#/components/schemas/pagination'
required:
- statement
- pagination
examples:
Transactions Statement Retrieved:
value:
statement:
period:
from: '2026-03-01T00:00:00.000Z'
to: '2026-03-31T23:59:59.999Z'
transactions:
- rates:
GBP-EUR: '1.15'
BTC-EUR: '60460.77'
transaction:
id: 8daa6dbd-21a0-4305-93c3-bd1d04bc575c
origin:
amount: '100'
asset: GBP
rate: '53484.17885426114102547488'
node:
id: d3401ecb-60dd-4d35-975b-1dfb58c0ba1a
network: sepa
ownerId: 5d894b41-270e-4162-a4f9-dae31bc53b1c
type: external-account
destination:
amount: '0.00186036'
asset: BTC
rate: '0.00001869711794070723'
node:
id: 9287ee0a-0bcb-43cf-9791-f96bb49ba3fb
ownerId: 5d894b41-270e-4162-a4f9-dae31bc53b1c
type: account
denomination:
amount: '100'
asset: GBP
target: origin
rate: '1'
fees:
- amount: '0.5'
asset: GBP
code: uphold
type: deposit
status: completed
quotedAt: '2026-03-23T11:57:00.000Z'
createdAt: '2026-03-23T11:58:00.000Z'
updatedAt: '2026-03-23T12:06:55.116Z'
completedAt: '2026-03-23T12:06:55.116Z'
pagination:
first: >-
https://api.enterprise.uphold.com/core/statements/transactions?denomination=EUR&period=one-month&year=2026&month=3&page=1&perPage=10
next: >-
https://api.enterprise.uphold.com/core/statements/transactions?denomination=EUR&period=one-month&year=2026&month=3&page=2&perPage=10
headers:
x-uphold-request-id:
description: >-
A unique identifier for the request that can be shared with Uphold
for troubleshooting purposes.
required: true
schema:
type: string
format: uuid
examples:
Request ID:
value: 9092ee4d-f0fb-42e9-8787-b668dbcec531
get-transactions-statement-conflict-response:
description: Business logic error.
content:
application/json:
schema:
$ref: '#/components/schemas/error'
examples:
Denomination Asset Not Supported:
value:
code: asset_not_supported
message: The denomination asset is not supported
details:
context: query
property: denomination
Statement Period Not Complete:
value:
code: date_invalid
message: The statement period is not yet complete
details:
context: query
Statement Period Before User Creation:
value:
code: date_invalid
message: The statement period predates the user creation date
details:
context: query
headers:
x-uphold-request-id:
description: >-
A unique identifier for the request that can be shared with Uphold
for troubleshooting purposes.
required: true
schema:
type: string
format: uuid
examples:
Request ID:
value: 9092ee4d-f0fb-42e9-8787-b668dbcec531
schemas:
transactions-statement:
type: object
properties:
period:
$ref: '#/components/schemas/statement-period'
transactions:
type: array
items:
$ref: '#/components/schemas/transactions-statement-entry'
required:
- period
- transactions
pagination:
description: The pagination information.
type: object
properties:
first:
description: The URL to the first set of results.
type: string
format: uri
prev:
description: The URL to the previous set of results.
type: string
format: uri
next:
description: The URL to the next set of results.
type: string
format: uri
error:
description: The error information.
type: object
properties:
code:
description: >-
A short string with a brief explanation about the error code
reported.
type: string
message:
description: A human-readable message providing more details about the error.
type: string
details:
description: Additional information about the error reported.
type: object
additionalProperties: true
required:
- code
- message
statement-period:
type: object
properties:
from:
type: string
format: date-time
description: The start of the statement period.
to:
type: string
format: date-time
description: The end of the statement period.
required:
- from
- to
transactions-statement-entry:
type: object
properties:
rates:
type: object
description: >-
Exchange rates keyed by asset-denomination pair (e.g. GBP-EUR,
BTC-EUR).
additionalProperties:
type: string
transaction:
$ref: '#/components/schemas/transaction'
required:
- rates
- transaction
transaction:
type: object
properties:
id:
description: The id of the transaction.
type: string
format: uuid
origin:
$ref: '#/components/schemas/transaction-origin-endpoint'
description: The origin of the transaction.
destination:
$ref: '#/components/schemas/transaction-destination-endpoint'
description: The destination of the transaction.
denomination:
$ref: '#/components/schemas/transaction-denomination'
description: The denomination of the transaction.
fees:
$ref: '#/components/schemas/transaction-fees'
description: The fees of the transaction.
status:
description: Status of the transaction.
type: string
enum:
- processing
- on-hold
- completed
- failed
statusDetails:
description: The details of the status of the transaction.
type: object
properties:
reason:
$ref: '#/components/schemas/transaction-status-reason'
quotedAt:
description: The time at which the quote was created.
type: string
format: date-time
createdAt:
description: The time at which the transaction was created.
type: string
format: date-time
updatedAt:
description: The last time at which the transaction was updated.
type: string
format: date-time
completedAt:
description: The date and time the transaction was completed.
type: string
format: date-time
required:
- id
- origin
- destination
- fees
- status
- createdAt
- updatedAt
- quotedAt
transaction-origin-endpoint:
type: object
properties:
asset:
description: The asset of the endpoint.
type: string
amount:
description: The amount of the endpoint.
type: string
rate:
description: >-
The rate of the endpoint against its counter-part (origin to
destination and vice-versa).
type: string
node:
$ref: '#/components/schemas/transaction-origin-node'
description: The node of the endpoint.
required:
- asset
- amount
- rate
- node
transaction-destination-endpoint:
type: object
properties:
asset:
description: The asset of the endpoint.
type: string
amount:
description: The amount of the endpoint.
type: string
rate:
description: >-
The rate of the endpoint against its counter-part (origin to
destination and vice-versa).
type: string
node:
$ref: '#/components/schemas/transaction-destination-node'
description: The node of the endpoint.
required:
- asset
- amount
- rate
- node
transaction-denomination:
type: object
properties:
asset:
description: The asset in which the transaction is denominated.
type: string
amount:
description: The amount of the transaction.
type: string
rate:
description: The rate against the specified target (origin or destination).
type: string
target:
description: >-
Whether this exact amount should be paid by the origin or received
by the destination.
type: string
enum:
- origin
- destination
required:
- asset
- amount
- rate
- target
transaction-fees:
type: array
items:
type: object
properties:
type:
description: The type of the fee.
type: string
enum:
- deposit
- exchange
- network
- withdrawal
code:
description: The code of the fee.
type: string
asset:
description: The asset in which the fee is denominated.
type: string
amount:
description: The amount of the fee.
type: string
percentage:
description: >-
The percentage of the fee, if the amount was calculated from a
percentage.
type: string
required:
- type
- code
- asset
- amount
transaction-status-reason:
description: The reason why the transaction failed.
type: string
enum:
- bank-account-holder-name-mismatch
- beneficiary-country-restricted
- card-declined-by-bank
- card-expired
- card-permanently-declined-by-bank
- card-unauthorized
- card-unsupported
- insufficient-funds
- pending-requests-for-information
- provider-maximum-limit-exceeded
- screening-verification-failed
- travel-rule-verification-failed
- velocity
- unspecified-error
transaction-origin-node:
type: object
discriminator:
propertyName: type
mapping:
account:
$ref: '#/components/schemas/transaction-node-account'
external-account:
$ref: '#/components/schemas/transaction-node-external-account'
bank-address:
$ref: '#/components/schemas/transaction-node-bank-address'
crypto-address:
$ref: '#/components/schemas/transaction-node-crypto-address'
oneOf:
- $ref: '#/components/schemas/transaction-node-account'
title: Account
- $ref: '#/components/schemas/transaction-node-external-account'
title: External account
- $ref: '#/components/schemas/transaction-node-bank-address'
title: Bank address
- $ref: '#/components/schemas/transaction-node-crypto-address'
title: Crypto address
transaction-destination-node:
type: object
discriminator:
propertyName: type
mapping:
account:
$ref: '#/components/schemas/transaction-node-account'
external-account:
$ref: '#/components/schemas/transaction-node-external-account'
bank-address:
$ref: '#/components/schemas/transaction-node-bank-address'
crypto-address:
$ref: '#/components/schemas/transaction-node-crypto-address'
oneOf:
- $ref: '#/components/schemas/transaction-node-account'
title: Account
- $ref: '#/components/schemas/transaction-node-external-account'
title: External account
- $ref: '#/components/schemas/transaction-node-bank-address'
title: Bank address
- $ref: '#/components/schemas/transaction-node-crypto-address'
title: Crypto address
transaction-node-account:
type: object
properties:
type:
description: The type of the node.
type: string
enum:
- account
id:
description: The account id.
type: string
format: uuid
ownerId:
description: The id of the user that owns the account.
type: string
format: uuid
required:
- type
- id
- ownerId
transaction-node-external-account:
type: object
properties:
type:
description: The type of the node.
type: string
enum:
- external-account
id:
description: The external account id.
type: string
format: uuid
confirmationUrl:
description: >-
The URL to confirm the authorization using the external account
(e.g., 3DS).
type: string
format: uri
ownerId:
description: The id of the user that owns the external account.
type: string
format: uuid
network:
description: The network used for the transaction with the external account.
type: string
required:
- type
- id
- ownerId
transaction-node-bank-address:
type: object
properties:
type:
description: The type of the node.
type: string
enum:
- bank-address
network:
description: The network of the bank transfer.
type: string
required:
- type
- network
transaction-node-crypto-address:
type: object
properties:
type:
description: The type of the node.
type: string
enum:
- crypto-address
network:
$ref: '#/components/schemas/string-no-edge-spaces'
description: The network that the crypto address is on.
address:
$ref: '#/components/schemas/string-no-edge-spaces'
description: The crypto address (may not be available for deposits).
reference:
description: >-
The additional identifier (e.g., destination tag, memo, or message)
for the crypto address.
type: string
execution:
$ref: '#/components/schemas/transaction-node-crypto-address-execution'
description: The execution details for the transaction.
required:
- type
- network
string-no-edge-spaces:
type: string
pattern: ^\S.*\S$|^\S$
transaction-node-crypto-address-execution:
type: object
discriminator:
propertyName: mode
mapping:
onchain:
$ref: >-
#/components/schemas/transaction-node-crypto-address-execution-onchain
offchain:
$ref: >-
#/components/schemas/transaction-node-crypto-address-execution-offchain
simulated:
$ref: >-
#/components/schemas/transaction-node-crypto-address-execution-simulated
oneOf:
- $ref: >-
#/components/schemas/transaction-node-crypto-address-execution-onchain
title: On-chain
- $ref: >-
#/components/schemas/transaction-node-crypto-address-execution-offchain
title: Off-chain
- $ref: >-
#/components/schemas/transaction-node-crypto-address-execution-simulated
title: Simulated
transaction-node-crypto-address-execution-onchain:
type: object
properties:
mode:
description: The mode of execution.
type: string
enum:
- onchain
transactionHash:
$ref: '#/components/schemas/string-no-edge-spaces'
description: The hash of the transaction in the blockchain.
required:
- mode
transaction-node-crypto-address-execution-offchain:
type: object
properties:
mode:
description: The mode of execution.
type: string
enum:
- offchain
accountId:
description: The account id to which the off-chain transaction was made.
type: string
format: uuid
accountOwnerId:
description: >-
The id of the user that owns the account to which the off-chain
transaction was made.
type: string
format: uuid
required:
- mode
transaction-node-crypto-address-execution-simulated:
type: object
properties:
mode:
description: The mode of execution.
type: string
enum:
- simulated
transactionHash:
$ref: '#/components/schemas/string-no-edge-spaces'
description: The simulated transaction hash.
required:
- mode
securitySchemes:
OAuth2:
type: oauth2
description: OAuth 2.0 authentication.
flows:
clientCredentials:
tokenUrl: /core/oauth2/token
scopes:
core.users:act-on-behalf-of: Grants access to act on behalf of a user
core.users:create: Grants access to create users
core.users:read: Grants access to view users
core.users:delete: Grants access to delete users
core.users.metadata:read: Grants access to view user metadata
core.users.metadata:write: Grants access to modify user metadata
core.kyc:read: Grants access to view KYC processes
core.kyc.profile:update: Grants access to update profile KYC process
core.kyc.address:update: Grants access to update address KYC process
core.kyc.email:update: Grants access to update email KYC process
core.kyc.phone:update: Grants access to update phone KYC process
core.kyc.identity:update: Grants access to update identity KYC process
core.kyc.proof-of-address:update: Grants access to update proof-of-address KYC process
core.kyc.customer-due-diligence:update: Grants access to update customer due diligence KYC process
core.kyc.enhanced-due-diligence:update: Grants access to update enhanced due diligence KYC process
core.kyc.crypto-risk-assessment:update: Grants access to update crypto risk assessment KYC process
core.kyc.self-categorization-statement:update: Grants access to update self-categorization statement KYC process
core.kyc.tax-details:update: Grants access to update tax details KYC process
core.capabilities:read: Grants access to view user capabilities
core.terms-of-service:read: Grants access to view terms of service
core.terms-of-service:accept: Grants access to accept terms of service
core.files:create: Grants access to create files
core.files:read: Grants access to view files
core.files.metadata:read: Grants access to view files metadata
core.files.metadata:write: Grants access to modify files metadata
core.accounts:create: Grants access to create accounts
core.accounts:read: Grants access to view accounts
core.accounts:update: Grants access to update accounts
core.accounts:archive: Grants access to archive accounts
core.accounts:deposit-method: >-
Grants access to deposit method needed for depositing into
accounts
core.accounts:use-test-helpers: Grants access to test helpers of accounts
core.accounts.metadata:read: Grants access to view accounts metadata
core.accounts.metadata:write: Grants access to modify accounts metadata
core.assets:use-test-helpers: Grants access to test helpers of assets
core.external-accounts:create: Grants access to create external accounts
core.external-accounts:read: Grants access to view external accounts
core.external-accounts:update: Grants access to update external accounts
core.external-accounts:delete: Grants access to delete external accounts
core.external-accounts.metadata:read: Grants access to view external accounts metadata
core.external-accounts.metadata:write: Grants access to modify external accounts metadata
core.transactions:create: Grants access to commit quotes
core.transactions:read: Grants access to view transactions
core.transactions.metadata:read: Grants access to view transactions metadata
core.transactions.metadata:write: Grants access to modify transactions metadata
core.transactions.requests-for-information:read: Grants access to view transactions requests for information
core.transactions.requests-for-information:update: Grants access to update transactions requests for information
core.portfolio:read: >-
Grants access to view portfolio overview, performance, and
historical balance
core.statements:read: Grants access to read statements
core.webhooks:management-link: Grants access to create webhook management links
````