Public developer API

GET /v1/bank-deposits/:id

Returns the account instructions and reconciliation status for one bank deposit.

Access

A project-specific API key (Authorization: Bearer dapi_live_...) and its Business ID (X-Business-Id). Rate limited per business (120 calls a minute by default).

Example request

curl --request GET \
  --url 'https://production.dutchapi.co/v1/bank-deposits/ID' \
  --header 'X-Business-Id: YOUR_BUSINESS_ID' \
  --header 'Authorization: Bearer bsk_live_YOUR_BUSINESS_SECRET'

Response 200

{
  "id": "bdep_8f2a1c",
  "object": "bank_deposit",
  "status": "processing",
  "amount": 50000,
  "currency": "NGN",
  "fee": 0,
  "bank_account": {
    "account_number": "0123456789",
    "account_name": "Acme Payments Ltd",
    "bank_name": "Eversend Test Bank",
    "reference": "TBA-NG-1",
    "amount": 50000,
    "currency": "NGN",
    "expires_at": "2026-10-13T09:40:00.000Z"
  },
  "reconciliation": {
    "status": "matched",
    "actual_amount": 50000,
    "actual_currency": "NGN"
  }
}

Errors

StatuserrorMeaning
404bank_deposit_not_foundNo Nigerian bank deposit with that id.

Related references

Browse the complete endpoint directory, the developer portal and the security and controls guide.