Transactions
Fetch transaction history from the Fiskil API.
AI Actions
The Transactions endpoint allows you to retrieve transaction history for an end user's bank accounts.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/transactions | List transactions for an end user |
The Transaction Model
| Attribute | Type | Description |
|---|---|---|
id | string | Unique identifier for the transaction |
account_id | string | ID of the account the transaction belongs to |
amount | number | Transaction amount (positive for credits, negative for debits) |
currency | string | Currency code (e.g., AUD) |
description | string | Transaction description |
merchant_name | string | Name of the merchant (if applicable) |
category | string | Transaction category |
status | string | Transaction status (POSTED, PENDING) |
type | string | Transaction type (DEBIT, CREDIT) |
posted_date | string | Date the transaction was posted |
execution_date | string | Date the transaction was executed |
reference | string | Transaction reference number |
Example Response
{
"id": "txn_abc123",
"account_id": "acc_123456789",
"amount": -45.50,
"currency": "AUD",
"description": "WOOLWORTHS 1234 SYDNEY",
"merchant_name": "Woolworths",
"category": "GROCERIES",
"status": "POSTED",
"type": "DEBIT",
"posted_date": "2023-01-15",
"execution_date": "2023-01-14",
"reference": "REF123456"
}List Transactions
Retrieve transactions for an end user's accounts.
GET https://api.fiskil.com/v1/transactionsQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
end_user_id | string | Yes | The ID of the end user |
account_id | string | No | Filter by specific account ID |
from_date | string | No | Start date for transaction range (YYYY-MM-DD) |
to_date | string | No | End date for transaction range (YYYY-MM-DD) |
min_amount | number | No | Minimum transaction amount |
max_amount | number | No | Maximum transaction amount |
status | string | No | Filter by status (POSTED, PENDING) |
limit | integer | No | Maximum number of results (default: 25) |
offset | integer | No | Number of results to skip |
Example Request
curl --request GET \
--url 'https://api.fiskil.com/v1/transactions?end_user_id=482c0e2b-5866-46b1-b795-220b7bba45b5&from_date=2023-01-01&to_date=2023-01-31' \
--header 'Authorization: Bearer {access_token}' \
--header 'accept: application/json; charset=UTF-8'const response = await fetch(
'https://api.fiskil.com/v1/transactions?end_user_id=482c0e2b-5866-46b1-b795-220b7bba45b5&from_date=2023-01-01&to_date=2023-01-31',
{
method: 'GET',
headers: {
'Authorization': 'Bearer {access_token}',
'accept': 'application/json; charset=UTF-8'
}
}
);
const transactions = await response.json();import requests
response = requests.get(
'https://api.fiskil.com/v1/transactions',
params={
'end_user_id': '482c0e2b-5866-46b1-b795-220b7bba45b5',
'from_date': '2023-01-01',
'to_date': '2023-01-31'
},
headers={
'Authorization': 'Bearer {access_token}',
'accept': 'application/json; charset=UTF-8'
}
)
transactions = response.json()Example Response
{
"data": [
{
"id": "txn_abc123",
"account_id": "acc_123456789",
"amount": -45.50,
"currency": "AUD",
"description": "WOOLWORTHS 1234 SYDNEY",
"merchant_name": "Woolworths",
"category": "GROCERIES",
"status": "POSTED",
"type": "DEBIT",
"posted_date": "2023-01-15",
"execution_date": "2023-01-14",
"reference": "REF123456"
},
{
"id": "txn_def456",
"account_id": "acc_123456789",
"amount": 3500.00,
"currency": "AUD",
"description": "SALARY ACME CORP",
"merchant_name": null,
"category": "INCOME",
"status": "POSTED",
"type": "CREDIT",
"posted_date": "2023-01-15",
"execution_date": "2023-01-15",
"reference": "SAL202301"
}
],
"links": {
"next": "https://api.fiskil.com/v1/transactions?end_user_id=482c0e2b-5866-46b1-b795-220b7bba45b5&offset=25"
}
}Transaction Categories
Common transaction categories:
| Category | Description |
|---|---|
GROCERIES | Grocery purchases |
DINING | Restaurants and food delivery |
TRANSPORT | Public transport, rideshare, parking |
UTILITIES | Electricity, gas, water, internet |
ENTERTAINMENT | Movies, streaming, events |
SHOPPING | Retail purchases |
HEALTH | Medical, pharmacy, fitness |
INCOME | Salary, wages, refunds |
TRANSFER | Account transfers |
FEES | Bank fees and charges |
OTHER | Uncategorized transactions |
Date Filtering
When filtering by date:
- Use ISO 8601 format:
YYYY-MM-DD from_dateis inclusive (transactions on or after this date)to_dateis inclusive (transactions on or before this date)- If no dates are specified, returns recent transactions (typically last 90 days)
Pagination
Transactions are returned in reverse chronological order (newest first). Use limit and offset for pagination, or follow the links.next URL.
Related Endpoints
Was this page helpful?