List Transactions
GET/v1/accounts/:accountId/transactions
Lists the Transactions for an Organization Account. Transactions are returned in date descending order.
Request
Path Parameters
Filter to an Account identifier.
Query Parameters
Page size. Must be between 1 and 100.
Page token to retrieve the next page of results.
Filter Transactions by credit (true), or debit (false).
From date, inclusive.
To date, inclusive.
Responses
- 200
- default
OK
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
transactions
object[]
required
The Transactions.
The Transaction identifier.
amount
object
required
Represents an amount of money with its currency type.
The whole units of the amount.
For example if currencyCode
is "USD"
, then 1 unit is one US dollar.
Number of nano (10^-9) units of the amount.
The value must be between -999,999,999 and +999,999,999 inclusive.
If units
is positive, nanos
must be positive or zero.
If units
is zero, nanos
can be positive, zero, or negative.
If units
is negative, nanos
must be negative or zero.
For example $-1.75 is represented as units
=-1 and nanos
=-750,000,000.
balance
object
required
Represents an amount of money with its currency type.
The whole units of the amount.
For example if currencyCode
is "USD"
, then 1 unit is one US dollar.
Number of nano (10^-9) units of the amount.
The value must be between -999,999,999 and +999,999,999 inclusive.
If units
is positive, nanos
must be positive or zero.
If units
is zero, nanos
can be positive, zero, or negative.
If units
is negative, nanos
must be negative or zero.
For example $-1.75 is represented as units
=-1 and nanos
=-750,000,000.
The date of the Transaction.
The Transaction description.
topup
object
A top-up Transaction
A reference for the Transaction.
The Transaction Payment type.
Possible values: [API
, PAYPAL
, BACS
]
dataInstance
object
A Transaction for a Data Instance.
The Data Instance identifier to which this Transaction relates.
adjustment
object
An adjustment Transaction.
The Data Instance identifier to which this Transaction relates.
The system administrator User identifier that made this change.
(Optional) Page token to retrieve the next page of results.
{
"transactions": [
{
"transactionId": "string",
"amount": {
"currencyCode": "string",
"units": "string",
"nanos": 0
},
"balance": {
"currencyCode": "string",
"units": "string",
"nanos": 0
},
"date": "2024-07-29T15:51:28.071Z",
"description": "string",
"topup": {
"reference": "string",
"source": "API"
},
"dataInstance": {
"dataInstanceId": "string"
},
"adjustment": {
"dataInstanceId": "string",
"administratorUserId": "string"
}
}
],
"nextPageToken": "string"
}
Error
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
An error status code describing the response.
Enum Value | Description |
---|---|
0 | OK |
1 | Cancelled |
2 | Unknown |
3 | InvalidArgument |
4 | DeadlineExceeded |
5 | NotFound |
6 | AlreadyExists |
7 | PermissionDenied |
8 | ResourceExhausted |
9 | FailedPrecondition |
10 | Aborted |
11 | OutOfRange |
12 | Unimplemented |
13 | Internal |
14 | Unavailable |
15 | DataLoss |
16 | Unauthenticated |
Possible values: [0
, 1
, 2
, 3
, 4
, 5
, 6
, 7
, 8
, 9
, 10
, 11
, 12
, 13
, 14
, 15
, 16
]
A developer-facing error message
details
object[]
A list of messages containing details about the errors
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}