GET

Get account transactions

language https://api.araucaria.money/v1/accounts/{accountId}/transactions

Returns transactions for a specific account with cursor-based pagination. Amounts are negative for debits (money out) and positive for credits (money in).

Parameters

Name	Type	Description
accountId *	path string
limit	query number	Number of items per page
starting_after	query string	Cursor to start after (returns items after this ID)

Request Example

bash

curl -X GET "https://api.araucaria.money/v1/accounts/{accountId}/transactions" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example

200 OK

json

{
  "data": [
    {
      "id": "txn_01HQ3K5J7X8Y9Z0A1B2C3D4E5F",
      "accountId": "acc_01HQ3K5J7X8Y9Z0A1B2C3D4E5F",
      "amount": -25000,
      "currency": "CLP",
      "description": "Supermercado Líder",
      "transactionDate": "2024-01-15",
      "category": "groceries",
      "status": "posted",
      "createdAt": "2024-01-15T14:30:00Z"
    },
    {
      "id": "txn_01HQ3K5J7X8Y9Z0A1B2C3D4E6G",
      "accountId": "acc_01HQ3K5J7X8Y9Z0A1B2C3D4E5F",
      "amount": 1500000,
      "currency": "CLP",
      "description": "Depósito de nómina",
      "transactionDate": "2024-01-01",
      "category": "income",
      "status": "posted",
      "createdAt": "2024-01-01T09:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "txn_01HQ3K5J7X8Y9Z0A1B2C3D4E6G"
}

Response Fields

Field	Type	Description
data *	TransactionResponseDto[]	Array of transactions
has_more *	boolean	Whether more results are available
next_cursor	string	Cursor to fetch the next page