Skip to main content
GET
https://api.cloud.blnkfinance.com
/
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.
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"
​
Authorization
string
required
Bearer token for authentication. Format: Bearer <access_token>. Your OAuth key must include data:read scope (or *).

​
Query parameters

​
instance_id
string
required
The Blnk Core instance ID to read from. Find this in Blnk Cloud under Instances.
​
page
integer
Page number to retrieve. Defaults to 1.
​
pageSize
integer
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
}
​
data
array
required
Array of transaction objects.
​
total
integer
required
Total number of transactions available.
Transactions may also include a "stats" field in the response for aggregate views.
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 [email protected] or send us a message here.