TRANSACTIONS

List transactions

GEThttps://production.dutchapi.co/v1/transactions

Lists every transaction on your organization, newest first: collections, deposits, payouts, withdrawals, swaps, conversions, card funding, card transactions and fees. Each has a kind saying what it is.

🔒Send the project API key as a Bearer token and your Business ID with this call.

kind is one of deposit, collection, withdrawal, disbursement, transfer, card_funding, card_transaction, swap, conversion, fee. Collections and payouts made with your project API key are collection and disbursement.

Query Params

kindstringoptional

Only this kind, for example collection or disbursement.

typestringoptional

Ledger type: payout, collection, exchange, funding, card_funding, card_transaction or fee.

statusstringoptional

processing, completed or failed.

limitintegeroptional

Page size.

offsetintegeroptional

Items to skip.

Responses

{
  "object": "list",
  "total": 1,
  "data": [
    {
      "id": "pyt_8f2c1a",
      "object": "payout",
      "kind": "disbursement",
      "status": "processing",
      "amount": 40000,
      "currency": "XAF",
      "fee": 300,
      "description": "Payout to Ada Obi",
      "created_at": "2026-10-13T09:30:00.000Z",
      "completed_at": null,
      "failure_reason": null,
      "funding": "balance",
      "rail": "bank",
      "recipient": {
        "name": "Ada Obi",
        "account": "******6789",
        "country": "NG"
      },
      "receive": {
        "amount": 88978.6,
        "currency": "NGN",
        "rate": 2.2244
      },
      "fees": {
        "currency": "XAF",
        "rule": "fixed",
        "ruleDetail": "Under 50,000 XAF: 300 XAF fixed",
        "dutchFee": 300,
        "markup": 100,
        "totalFee": 400
      }
    }
  ]
}

{
  "error": "insufficient_scope",
  "message": "This project key is not allowed to do that."
}

Errors

Status	error	Meaning
403	`insufficient_scope`	This project key is not allowed to do that.

Updated 2026

Did this page help you?

PreviousConvert with a locked rate NextSet the webhook endpoint

Language

CredentialsBearer

curl --request GET --url "https://production.dutchapi.co/v1/transactions" \
  --header "Authorization: Bearer $DUTCH_PROJECT_KEY" \
  --header "X-Business-Id: $DUTCH_BUSINESS_ID"

const res = await fetch("https://production.dutchapi.co/v1/transactions", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.DUTCH_PROJECT_KEY,
    "X-Business-Id": process.env.DUTCH_BUSINESS_ID,
  }
});
console.log(await res.json());

require "net/http"
require "json"

uri = URI("https://production.dutchapi.co/v1/transactions")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch('DUTCH_PROJECT_KEY')}"
req["X-Business-Id"] = ENV.fetch("DUTCH_BUSINESS_ID")
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

<?php
$ch = curl_init("https://production.dutchapi.co/v1/transactions");
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("DUTCH_PROJECT_KEY"),
    "X-Business-Id: " . getenv("DUTCH_BUSINESS_ID")],
]);
echo curl_exec($ch);

import os, requests

res = requests.request(
    "GET",
    "https://production.dutchapi.co/v1/transactions",
    headers={
        "Authorization": "Bearer " + os.environ["DUTCH_PROJECT_KEY"],
        "X-Business-Id": os.environ["DUTCH_BUSINESS_ID"],
    }
)
print(res.json())

Response

Click `Show example` to see an example response. Nothing is sent from this page: endpoints are live, so run real requests from your own code with small amounts.