Skip to main content
POST
/
v1
/
ais
/
accounts
/
transactions
Get Account Transactions
curl --request POST \
  --url https://acount-apis-staging-a8cdb2402163.herokuapp.com/v1/ais/accounts/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": "user_35100188",
  "merchantId": 1,
  "accountId": "a:6CpoqfjmyhfT9QAbcTZ2gcnb8egGfKLKMpxzuZPoaMLB:BzQQ5nvcb7TM4Qts",
  "pageLimit": 200,
  "fromDate": "2024-01-01T00:00:00Z",
  "toDate": "2024-01-31T23:59:59Z"
}
'
{
  "userId": "user_2abc123def456",
  "merchantId": 1,
  "accountId": "a:6CpoqfjmyhfT9QAbcTZ2gcnb8egGfKLKMpxzuZPoaMLB:BzQQ5nvcb7TM4Qts",
  "totalTransactions": 25,
  "pageLimit": 200,
  "transactions": [
    {
      "transactionId": "txn_123456",
      "amount": "100.50",
      "currency": "DKK",
      "description": "Payment to merchant",
      "bookingDate": "2024-01-15T10:30:00Z",
      "valueDate": "2024-01-15T10:30:00Z",
      "counterparty": {
        "name": "John Doe",
        "iban": "DK5000400440116243"
      },
      "reference": "REF123456",
      "type": "DEBIT",
      "status": "BOOKED"
    }
  ]
}
Retrieves transactions for a specific account using Token.io’s /accounts/{accountId}/transactions endpoint.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-request-id
string

Request ID for tracking

Body

application/json
​
userId
string
required

User ID (Clerk user ID)

Example:

"user_35100188"

​
merchantId
integer
required

Merchant ID (numeric)

Example:

1

​
accountId
string
required

Account ID from Token.io

Example:

"a:6CpoqfjmyhfT9QAbcTZ2gcnb8egGfKLKMpxzuZPoaMLB:BzQQ5nvcb7TM4Qts"

​
pageLimit
number
default:200

Page limit for transactions (default: 200)

Example:

200

​
fromDate
string

Start date for transactions (ISO 8601)

Example:

"2024-01-01T00:00:00Z"

​
toDate
string

End date for transactions (ISO 8601)

Example:

"2024-01-31T23:59:59Z"

Response

Account transactions retrieved successfully

​
userId
string

User ID

Example:

"user_2abc123def456"

​
merchantId
integer

Merchant ID

Example:

1

​
accountId
string

Account ID

Example:

"a:6CpoqfjmyhfT9QAbcTZ2gcnb8egGfKLKMpxzuZPoaMLB:BzQQ5nvcb7TM4Qts"

​
totalTransactions
number

Total number of transactions

Example:

25

​
pageLimit
number

Page limit used

Example:

200

​
transactions
object[]

Array of transactions