Authentication
Proxy API
Data API
Data API
List transactions
List all transactions from your Blnk Core instance with pagination support.
GET
/
data
/
transactions
curl -X GET "https://api.cloud.blnkfinance.com/data/transactions?instance_id=YOUR_INSTANCE_ID&page=1&pageSize=20" \
-H "Authorization: Bearer blnk_at_YOUR_ACCESS_TOKEN"
{
"data": [
{
"transaction_id": "txn_c4e70eb8-e4d6-4e04-a2e2-92a43b969e0c",
"amount": 100.50,
"currency": "USD",
"source": "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
"destination": "bln_ANOTHER_BALANCE_ID",
"status": "APPLIED",
"created_at": "2024-11-26T08:40:00.000000000Z",
"precision": 100,
"meta_data": {
"myApp": {
"channel": "web",
"approval_status": "approved"
}
}
}
],
"total": 42
}
Retrieve a paginated list of transactions from your Blnk Core instance.Documentation Index
Fetch the complete documentation index at: https://guide.cloud.blnkfinance.com/llms.txt
Use this file to discover all available pages before exploring further.
For in-depth information about Blnk’s ledger, balance, transaction, and identity APIs, see the Blnk Core docs.
Request structure
curl -X GET "https://api.cloud.blnkfinance.com/data/transactions?instance_id=YOUR_INSTANCE_ID&page=1&pageSize=20" \
-H "Authorization: Bearer blnk_at_YOUR_ACCESS_TOKEN"
Bearer token for authentication. Format:
Bearer <access_token>. Your OAuth key must include data:read scope (or *).Query parameters
The Blnk Core instance ID to read from. Find this in Blnk Cloud under Instances.
Page number to retrieve. Defaults to
1.Number of results per page. Defaults to
20 for transactions.Response structure
{
"data": [
{
"transaction_id": "txn_c4e70eb8-e4d6-4e04-a2e2-92a43b969e0c",
"amount": 100.50,
"currency": "USD",
"source": "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
"destination": "bln_ANOTHER_BALANCE_ID",
"status": "APPLIED",
"created_at": "2024-11-26T08:40:00.000000000Z",
"precision": 100,
"meta_data": {
"myApp": {
"channel": "web",
"approval_status": "approved"
}
}
}
],
"total": 42
}
Array of transaction objects.
Total number of transactions available.
Transactions may also include a
"stats" field in the response for aggregate views.Show Transaction object properties
Show Transaction object properties
Unique identifier for the transaction.
Transaction amount.
Currency code for the transaction.
Balance ID debited from.
Balance ID credited to.
Current status of the transaction (e.g.,
QUEUED, APPLIED, FAILED).ISO 8601 formatted timestamp of when the transaction was created.
For filters and supported fields, see the Data API docs.
Need help?
If you’re having trouble with Blnk Cloud, don’t hesitate to send us a message via email at support@blnkfinance.com or send us a message here.⌘I
curl -X GET "https://api.cloud.blnkfinance.com/data/transactions?instance_id=YOUR_INSTANCE_ID&page=1&pageSize=20" \
-H "Authorization: Bearer blnk_at_YOUR_ACCESS_TOKEN"
{
"data": [
{
"transaction_id": "txn_c4e70eb8-e4d6-4e04-a2e2-92a43b969e0c",
"amount": 100.50,
"currency": "USD",
"source": "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
"destination": "bln_ANOTHER_BALANCE_ID",
"status": "APPLIED",
"created_at": "2024-11-26T08:40:00.000000000Z",
"precision": 100,
"meta_data": {
"myApp": {
"channel": "web",
"approval_status": "approved"
}
}
}
],
"total": 42
}