Accounts - Nuvion

Accounts hold balances for an entity. Each account is denominated in a single currency. An entity must have approved status before accounts can be created for them.

The Account object

string

Unique account identifier.

string

The ID of the entity this account belongs to.

string

Account type. One of checking, debit, operational, or safeguard.

string

ISO 4217 currency code.Fiat: E.g. USD, GBP, EUR, NGN, KESStablecoin: USC (USDC), UST (USDT), RLD

string

Human-readable label for the account.

string

Nuvion internal bank account number used for routing. Treat this as read-only.

object

Current balance state of the account. All amounts are in the smallest currency unit (e.g. cents for USD).

Show balance fields

number

Spendable funds, excluding amounts pending settlement. Use this value when checking whether an entity has sufficient funds.

number

Total balance including amounts pending settlement.

number

Amount of the account’s overdraft limit currently drawn down.

string

Unique identifier for the account’s underlying balance record.

object

Account-level configuration.

Show config fields

boolean

Whether this account is permitted to go into overdraft.

number

Maximum overdraft amount allowed, in the smallest currency unit.

number

How often, in minutes, the account balance is refreshed from the underlying ledger.

number

Unix timestamp in milliseconds of the next scheduled balance refresh. 0 if refreshed on demand.

object

Stablecoin-specific balance detail. Empty for fiat accounts.

boolean

Whether this account is excluded from maintenance fees.

object

Internal metadata reserved for Nuvion. Not settable via the API.

object

Set of key-value pairs for storing additional platform-defined data.

number

0 if the account is active. Non-zero if the account has been deleted.

number

Unix timestamp in milliseconds when the account was created.

number

Unix timestamp in milliseconds when the account was last updated.

Example

{
  "id": "01HXYZ5678ABCDEFGHJKMNPQRS",
  "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
  "type": "checking",
  "currency": "USD",
  "display_name": "Main USD Account",
  "nuvion_ban": "NVN0000012345",
  "balance": {
    "available": 150000,
    "current": 150000,
    "overdraft_used": 0
  },
  "balance_id": "100000000000000000000000000000001",
  "config": {
    "is_overdraftable": false,
    "overdraft_limit": 0,
    "balance_refresh_interval": 15,
    "balance_next_refresh": 0
  },
  "stablecoin_assets": {},
  "maintenance_fee_opted_out": false,
  "system_meta": {},
  "meta": {},
  "deleted": 0,
  "created": 1735725600000,
  "updated": 1735725600000
}

Always use balance.available when checking if an entity has sufficient funds. balance.current includes amounts pending settlement that are not yet spendable.

Create an account

POST /accounts Creates a new account for an approved entity. The entity must have status: "approved" before accounts can be opened.

curl -X POST https://api.nuvion.dev/accounts \
  -H "Authorization: Bearer $NUVION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
    "type": "checking",
    "currency": "USD",
    "display_name": "Main USD Account"
  }'

To create a stablecoin account, pass one of USC, UST, RLD as your currency.

Request parameters

string

The ID of the entity to open this account for. The entity must have status: "approved". Defaults to the authenticating entity when omitted. Required when acting on a child entity. See Managing child entities for details.

string

required

Account type. One of checking, debit, operational, or safeguard.

string

required

ISO 4217 currency code for the account.

string

required

Human-readable label for the account. Maximum 100 characters.

object

Key-value metadata to attach to the account. Values must be strings.

Response

Returns the created account object. The balance is 0 for both available and current at creation.

Response

{
  "status": "success",
  "message": "Account created successfully",
  "data": {
    "account": {
      "id": "01HXYZ5678ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
      "type": "checking",
      "currency": "USD",
      "display_name": "Main USD Account",
      "config": {
        "overdraft_limit": 0,
        "balance_next_refresh": 0,
        "is_overdraftable": false,
        "balance_refresh_interval": 15
      },
      "balance": {
        "available": 0,
        "current": 0,
        "overdraft_used": 0
      },
      "stablecoin_assets": {},
      "maintenance_fee_opted_out": false,
      "system_meta": {},
      "created": 1787286465766,
      "updated": 1787286465766,
      "deleted": 0,
      "meta": {},
      "nuvion_ban": "0010759002"
    },
    "entity_impact": {
      "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
      "total_accounts": 62,
      "account_type": [
        "checking"
      ],
      "default_account_set": true
    }
  }
}

object

Returned only when creating an account. Summarizes the effect this account had on the owning entity.

Show entity_impact fields

string

The ID of the entity this account was created for.

number

Total number of accounts the entity now has.

array

Account types the entity currently holds.

boolean

Whether this account was set as the entity’s default account.

The first account created for an entity automatically becomes their default account.

Get an account

GET /accounts/{account_id} Retrieves an existing account by ID.

curl "https://api.nuvion.dev/accounts/01HXYZ6789ABCDEFGHJKMNPQRS?entity_id=01HXYZ3456ABCDEFGHJKMNPQRS" \
  -H "Authorization: Bearer $NUVION_API_KEY"

Path parameters

string

required

The ID of the account to retrieve.

Query parameters

string

The ID of the entity that owns the account. Defaults to the authenticating entity when omitted. Required when acting on a child entity. See Managing child entities for details.

Response

Returns the account object.

Response

{
  "status": "success",
  "message": "Account retrieved successfully",
  "data": {
    "account": {
      "id": "01HXYZ6789ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ3456ABCDEFGHJKMNPQRS",
      "type": "checking",
      "currency": "USD",
      "display_name": "USD FIAT account",
      "config": {
        "overdraft_limit": 0,
        "balance_next_refresh": 0,
        "is_overdraftable": false,
        "balance_refresh_interval": 15
      },
      "balance": {
        "current": 0,
        "available": 0,
        "overdraft_used": 0
      },
      "maintenance_fee_opted_out": false,
      "created": 1787136845042,
      "updated": 1787136845694,
      "deleted": 0,
      "nuvion_ban": "0010645678",
      "balance_id": "100000000000000000000000000000001",
      "stablecoin_assets": []
    },
    "entity": {
      "id": "01HXYZ3456ABCDEFGHJKMNPQRS",
      "name": "Everything-Empire",
      "type": "business",
      "verification_status": "approved"
    },
    "account_details": [],
    "pinned_status": {
      "is_pinned": false,
      "pinned_at": null,
      "pinned_by_count": null
    },
    "counterparties_summary": {
      "total_active": 0,
      "total_inactive": 0,
      "recent_activity": 0
    },
    "compliance_status": {
      "risk_level": "low",
      "sanctions_status": "clear",
      "monitoring_level": "standard",
      "last_reviewed": 1672531500000,
      "flags": []
    }
  }
}

Update an account

PATCH /accounts/{account_id} Updates an existing account. Only display_name can be changed after creation.

curl -X PATCH https://api.nuvion.dev/accounts/01HXYZ9012ABCDEFGHJKMNPQRS \
  -H "Authorization: Bearer $NUVION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "Main NGN Account (Updated)"
  }'

Path parameters

string

required

The ID of the account to update.

Request parameters

string

required

New human-readable label for the account. Maximum 100 characters. This is the only field that can be updated after creation.

string

Defaults to the authenticating entity when omitted. Required when acting on a child entity. See Managing child entities for details.

Response

Returns the updated account object, along with a summary of what changed.

Response

{
  "status": "success",
  "message": "Account updated successfully",
  "data": {
    "account": {
      "id": "01HXYZ9012ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ2345ABCDEFGHJKMNPQRS",
      "type": "checking",
      "currency": "NGN",
      "display_name": "Main NGN Account (Updated)",
      "config": {
        "overdraft_limit": 0,
        "balance_next_refresh": 0,
        "is_overdraftable": false,
        "balance_refresh_interval": 15
      },
      "balance": {
        "available": 0,
        "current": 0,
        "overdraft_used": 0
      },
      "maintenance_fee_opted_out": false,
      "created": 1783419441073,
      "updated": 1787671008974,
      "deleted": 0,
      "nuvion_ban": "NVXYT1GUCM",
      "balance_id": "100000000000000000000000000000001",
      "meta": {}
    },
    "changes_applied": {
      "fields_updated": [
        "display_name"
      ],
      "config_changes": [],
      "status_changed": false,
      "overdraft_limit_impact": {
        "previous_limit": 0,
        "new_limit": 0
      },
      "compliance_recheck_triggered": false
    }
  }
}

Delete an account

DELETE /accounts/{account_id} Deletes an account. The account must have a zero balance before it can be deleted. Related account details and pinned-account references are removed as part of the same request.

Path parameters

string

required

The ID of the account to delete.

Request parameters

string

Defaults to the authenticating entity when omitted. Required when acting on a child entity. See Managing child entities for details.

curl -X DELETE https://api.nuvion.dev/accounts/01HXYZ9012ABCDEFGHJKMNPQRS \
  -H "Authorization: Bearer $NUVION_API_KEY"

Response

{
  "status": "success",
  "message": "Account deleted successfully",
  "data": {
    "account": {
      "id": "01HXYZ9012ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ2345ABCDEFGHJKMNPQRS",
      "type": "checking",
      "currency": "USD",
      "display_name": "Secondary USD Account",
      "config": {
        "overdraft_limit": 0,
        "balance_next_refresh": 0,
        "is_overdraftable": false,
        "balance_refresh_interval": 15
      },
      "balance": 0,
      "maintenance_fee_opted_out": false,
      "created": 1783419441073,
      "updated": 1787844000000,
      "deleted": 0,
      "nuvion_ban": "NVXYT1GUCM",
      "balance_id": "100000000000000000000000000000002",
      "final_balance": {
        "current": 0,
        "overdraft_used": 0
      },
      "cascade_deletions": {
        "account_details": [
          "01HXYZ8001ABCDEFGHJKMNPQRS"
        ],
        "pinned_accounts": [
          "01HXYZ2345ABCDEFGHJKMNPQRS:01HXYZ9012ABCDEFGHJKMNPQRS"
        ],
        "counterparties": [],
        "transactions_affected": 0,
        "pending_transactions_cancelled": 0
      }
    },
    "entity_impact": {
      "entity_id": "01HXYZ2345ABCDEFGHJKMNPQRS",
      "remaining_accounts": 2,
      "default_account_reassigned": "",
      "accounts_of_same_type": 1
    },
    "reversal_info": {
      "can_be_restored": true,
      "restoration_deadline": 1788448800000,
      "restoration_requirements": [
        "admin_approval"
      ],
      "balance_recovery_possible": true
    }
  }
}

object

The deleted account.

Show account.cascade_deletions fields

array

IDs of account details records removed along with the account.

array

entity_id:account_id pairs removed from pinned-account references.

array

Counterparties that referenced this account and were affected.

number

Number of transactions affected by the deletion.

number

Number of pending transactions cancelled by the deletion.

object

Summary of the effect on the owning entity.

Show entity_impact fields

number

The entity’s total account count after this deletion.

string

The ID of the account that became the new default, if reassignment occurred. Empty when not applicable.

number

The entity’s remaining account count of the same type as the deleted account.

object

Whether and how the deletion can be reversed.

Show reversal_info fields

boolean

Whether the account can still be restored.

number

Unix timestamp in milliseconds after which the account can no longer be restored.

array

Conditions that must be met to restore the account. e.g. admin_approval.

boolean

Whether the account’s balance can be recovered if restored.

List accounts

GET /accounts Returns a paginated list of accounts. Filter by entity, currency, or account type.

curl "https://api.nuvion.dev/accounts?entity_id=01HXYZ2345ABCDEFGHJKMNPQRS&limit=20" \
  -H "Authorization: Bearer $NUVION_API_KEY"

Query parameters

string

Filter accounts by entity ID. Defaults to the authenticating entity when omitted. Required when acting on a child entity. See Managing child entities for details.

string

Filter by ISO 4217 currency code (e.g. USD).

string

Filter by account type. One of checking, debit, operational, or safeguard.

integer

Number of results to return. Between 1 and 100. Defaults to 20.

string

Pagination cursor from a previous response. Omit for the first page.

Response

Returns a paginated list of account objects.

Response

{
  "status": "success",
  "message": "Accounts retrieved successfully",
  "data": {
    "data": [
      {
        "entity_id": "01HXYZ2345ABCDEFGHJKMNPQRS",
        "type": "checking",
        "currency": "NGN",
        "display_name": "Main NGN Account",
        "config": {
          "is_overdraftable": false,
          "overdraft_limit": 0
        },
        "nuvion_ban": "NVXYT1GUCM",
        "created": 1761820364358,
        "updated": 1784718768076,
        "balance": {
          "current": 104727,
          "available": 104727,
          "overdraft_used": 0
        },
        "id": "01HXYZ9012ABCDEFGHJKMNPQRS",
        "status": "active"
      }
    ],
    "meta": {
      "pagination": {
        "order": "asc",
        "has_next": true,
        "limit": 1,
        "has_previous": false,
        "next_cursor": "01HXYZ9012ABCDEFGHJKMNPQRS",
        "previous_cursor": null
      },
      "filters_applied": {
        "parent_account_id": null,
        "entity_id": "01HXYZ2345ABCDEFGHJKMNPQRS",
        "type": {},
        "sort": {
          "field": "created",
          "order": "asc"
        }
      }
    }
  }
}

Get account statements

GET /accounts/{account_id}/statements Retrieves a statement of transactions for an account over a given month.

curl "https://api.nuvion.dev/accounts/01HXYZ7890ABCDEFGHJKMNPQRS/statements?year=2026&month=5&limit=100&include_pending=true" \
  -H "Authorization: Bearer $NUVION_API_KEY"

Path parameters

string

required

The ID of the account to generate a statement for.

Query parameters

integer

required

The statement year. e.g. 2026.

integer

required

The statement month. 1–12.

integer

Number of transactions to return. Between 1 and 100. Defaults to 20.

boolean

Whether to include transactions that haven’t settled yet. Defaults to false.

string

Defaults to the authenticating entity when omitted. Required when acting on a child entity. See Managing child entities for details.

Response

Returns a statement summary with matching transactions for the requested period.

Pending transactions haven’t settled yet, so they don’t affect running_balance or the summary balances totals until they complete.

string

The ID of the account this statement covers.

string

Name on the account at the time the statement was generated.

string

ISO 4217 currency code of the account.

string

Nuvion internal bank account number for the account.

object

Postal address on file for the account holder at the time the statement was generated.

string

ISO 8601 timestamp of when the statement was generated.

object

The date range the statement covers.

Show period fields

string

ISO 8601 timestamp for the start of the statement period.

string

ISO 8601 timestamp for the end of the statement period.

object

Summary totals for the statement period. All amounts are in the smallest currency unit.

Show balances fields

number

Account balance at the start of the period.

number

Account balance at the end of the period.

number

Sum of all credit transactions in the period.

number

Sum of all debit transactions in the period.

number

Sum of all fees charged in the period.

array

Transactions that occurred in the statement period, ordered oldest to newest.

Show transaction fields

string

Unique transaction identifier.

string

ISO 8601 timestamp of when the transaction occurred.

string

Transaction direction, e.g. credit or debit.

string

Human-readable description of the transaction.

object

The other party on the transaction.

Show counterparty fields

string

Counterparty name.

string

Masked counterparty account number, where available. null if not applicable to this transaction.

number

Transaction amount before fees, in the smallest currency unit.

number

Fee charged on this transaction, in the smallest currency unit.

number

Amount applied to the account balance after fees.

number

Account balance immediately after this transaction was applied. Unaffected by transactions still pending.

string

Idempotency or tracking reference for the transaction. Format varies by transaction source.

string

Transaction status, e.g. completed, pending.

string

ISO 4217 currency code the transaction was recorded in on this account.

object

Currency conversion detail. Only present when the transaction involved a currency conversion.

Show fx fields

string

Currency the transaction originated in.

string

Currency the transaction settled in.

number

Exchange rate applied.

number

Amount in source_currency, in its smallest currency unit.

number

Amount in destination_currency, in its smallest currency unit.

object

Pagination detail for the transaction list.

Show pagination fields

string

Sort order applied. One of asc or desc.

boolean

Whether more transactions exist after this page.

boolean

Whether more transactions exist before this page.

integer

Number of transactions requested per page.

string

Cursor for the next page. null if there is no next page.

string

Cursor for the previous page. null if there is no previous page.

integer

Total number of transactions matching the request.

Response

{
  "status": "success",
  "message": "Account statement retrieved successfully",
  "data": {
    "account_id": "01HXYZ7890ABCDEFGHJKMNPQRS",
    "account_holder": "Alex Johnson",
    "account_currency": "USD",
    "ban": "NVN0000012345",
    "address": {
      "line_1": "1 Example Street",
      "line_2": null,
      "line_3": null,
      "city": "Lagos",
      "state": "Lagos",
      "postal_code": "101232",
      "country_code": "NG"
    },
    "generated_at": "2026-05-25T15:22:54.373Z",
    "period": {
      "start_date": "2026-05-01T00:00:00.000Z",
      "end_date": "2026-05-25T15:22:54.373Z"
    },
    "balances": {
      "opening_balance": 947893,
      "closing_balance": 187687,
      "total_credits": 0,
      "total_debits": 754179,
      "total_fees": 6027
    },
    "transactions": [
      {
        "transaction_id": "01HXYZ8001ABCDEFGHJKMNPQRS",
        "date": "2026-05-03T12:28:15.618Z",
        "type": "debit",
        "description": "Test Funding",
        "counterparty": {
          "name": "Test Main checking account",
          "account_number": "XXXXXX6002"
        },
        "amount": 500000,
        "fee": 0,
        "net_amount": 500000,
        "running_balance": 447893,
        "reference": "00000000-0000-0000-0000-000000000001",
        "status": "completed",
        "currency": "USD",
        "fx": {
          "source_currency": "USD",
          "destination_currency": "NGN",
          "rate": 1315.440043,
          "source_amount": 500000,
          "destination_amount": 657720021
        }
      },
      {
        "transaction_id": "01HXYZ8002ABCDEFGHJKMNPQRS",
        "date": "2026-05-04T06:14:33.045Z",
        "type": "debit",
        "description": "Test Swift Payout",
        "counterparty": {
          "name": "TEST_Acme Legal Asia",
          "account_number": "XXXXXXXXXXXXXXXXXX4484"
        },
        "amount": 5893,
        "fee": 590,
        "net_amount": 5303,
        "running_balance": 447893,
        "reference": "REF-1785824070816-3337",
        "status": "pending",
        "currency": "USD",
        "fx": {
          "source_currency": "USD",
          "destination_currency": "EUR",
          "rate": 0.848481,
          "source_amount": 5893,
          "destination_amount": 5000
        }
      },
      {
        "transaction_id": "01HXYZ8003ABCDEFGHJKMNPQRS",
        "date": "2026-05-04T06:59:19.985Z",
        "type": "debit",
        "description": "Test AUD Payout",
        "counterparty": {
          "name": "Acme IP Pty Ltd",
          "account_number": "XXXX8147"
        },
        "amount": 3680,
        "fee": 0,
        "net_amount": 3680,
        "running_balance": 447893,
        "reference": "REF-1785826757822-6312",
        "status": "pending",
        "currency": "USD",
        "fx": {
          "source_currency": "USD",
          "destination_currency": "AUD",
          "rate": 1.358783,
          "source_amount": 3680,
          "destination_amount": 5000
        }
      },
      {
        "transaction_id": "01HXYZ8004ABCDEFGHJKMNPQRS",
        "date": "2026-05-05T10:57:02.662Z",
        "type": "debit",
        "description": "Test USD SWIFT Payout",
        "counterparty": {
          "name": "Acme IP Pty Ltd",
          "account_number": "XXXXXXXX1158"
        },
        "amount": 5000,
        "fee": 5025,
        "net_amount": -25,
        "running_balance": 437868,
        "reference": "REF-1785927416953-273",
        "status": "completed",
        "currency": "USD"
      },
      {
        "transaction_id": "01HXYZ8005ABCDEFGHJKMNPQRS",
        "date": "2026-05-05T10:58:46.417Z",
        "type": "debit",
        "description": "Test USD ACH Payout",
        "counterparty": {
          "name": "Acme IP Pty Ltd",
          "account_number": "XXXXXXXX7206"
        },
        "amount": 5000,
        "fee": 500,
        "net_amount": 4500,
        "running_balance": 437868,
        "reference": "REF-1785927523521-9758",
        "status": "pending",
        "currency": "USD"
      },
      {
        "transaction_id": "01HXYZ8006ABCDEFGHJKMNPQRS",
        "date": "2026-05-05T11:01:57.145Z",
        "type": "debit",
        "description": "Test EUR Payout",
        "counterparty": {
          "name": "Acme IP Pty Ltd",
          "account_number": "XXXXXXXXXXXXXXXXXX3000"
        },
        "amount": 592,
        "fee": 592,
        "net_amount": 0,
        "running_balance": 437868,
        "reference": "REF-1785927714584-5543",
        "status": "pending",
        "currency": "USD",
        "fx": {
          "source_currency": "USD",
          "destination_currency": "EUR",
          "rate": 0.845909,
          "source_amount": 592,
          "destination_amount": 500
        }
      },
      {
        "transaction_id": "01HXYZ8007ABCDEFGHJKMNPQRS",
        "date": "2026-05-05T11:03:08.271Z",
        "type": "debit",
        "description": "Test USD ACH Payout",
        "counterparty": {
          "name": "Acme IP Pty Ltd",
          "account_number": "XXXXXXXX5369"
        },
        "amount": 5000,
        "fee": 500,
        "net_amount": 4500,
        "running_balance": 432368,
        "reference": "REF-1785927781876-438",
        "status": "completed",
        "currency": "USD"
      },
      {
        "transaction_id": "01HXYZ8008ABCDEFGHJKMNPQRS",
        "date": "2026-05-05T14:23:22.629Z",
        "type": "debit",
        "description": "Test Funding",
        "counterparty": {
          "name": "Acme Corp",
          "account_number": "XXXXXX6002"
        },
        "amount": 228061,
        "fee": 0,
        "net_amount": 228061,
        "running_balance": 204307,
        "reference": "00000000-0000-0000-0000-000000000002",
        "status": "completed",
        "currency": "USD",
        "fx": {
          "source_currency": "USD",
          "destination_currency": "NGN",
          "rate": 1315.440043,
          "source_amount": 228061,
          "destination_amount": 300000000
        }
      },
      {
        "transaction_id": "01HXYZ8009ABCDEFGHJKMNPQRS",
        "date": "2026-05-14T12:55:07.303Z",
        "type": "debit",
        "description": "Nuvion Flex 90 FR order",
        "counterparty": {
          "name": "Nuvion Flex 90",
          "account_number": null
        },
        "amount": 10000,
        "fee": 0,
        "net_amount": 10000,
        "running_balance": 194307,
        "reference": "01HXYZ8109ABCDEFGHJKMNPQRS",
        "status": "completed",
        "currency": "USD"
      },
      {
        "transaction_id": "01HXYZ8010ABCDEFGHJKMNPQRS",
        "date": "2026-05-14T13:10:18.118Z",
        "type": "debit",
        "description": "Test USD ACH Payout",
        "counterparty": {
          "name": "Acme IP Pty Ltd",
          "account_number": "XXXXXXXX5369"
        },
        "amount": 5000,
        "fee": 500,
        "net_amount": 4500,
        "running_balance": 188807,
        "reference": "REF-1786713016155-8014",
        "status": "completed",
        "currency": "USD"
      },
      {
        "transaction_id": "01HXYZ8011ABCDEFGHJKMNPQRS",
        "date": "2026-05-17T12:35:41.747Z",
        "type": "debit",
        "description": "REF-1786970139410-1419",
        "counterparty": {
          "name": "Jane Smith",
          "account_number": "XXXXXXXXX3456"
        },
        "amount": 59,
        "fee": 1,
        "net_amount": 58,
        "running_balance": 188747,
        "reference": "REF-1786970139410-1419",
        "status": "completed",
        "currency": "USD",
        "fx": {
          "source_currency": "USD",
          "destination_currency": "TZS",
          "rate": 2575.878054,
          "source_amount": 59,
          "destination_amount": 150000
        }
      },
      {
        "transaction_id": "01HXYZ8012ABCDEFGHJKMNPQRS",
        "date": "2026-05-22T18:53:05.925Z",
        "type": "debit",
        "description": "REF-1787424783622-7510",
        "counterparty": {
          "name": "Jane Smith",
          "account_number": "XXXXXXXXX3456"
        },
        "amount": 59,
        "fee": 1,
        "net_amount": 58,
        "running_balance": 188687,
        "reference": "REF-1787424783622-7510",
        "status": "completed",
        "currency": "USD",
        "fx": {
          "source_currency": "USD",
          "destination_currency": "TZS",
          "rate": 2573.76549,
          "source_amount": 59,
          "destination_amount": 150000
        }
      },
      {
        "transaction_id": "01HXYZ8013ABCDEFGHJKMNPQRS",
        "date": "2026-05-25T11:07:42.134Z",
        "type": "debit",
        "description": "Test Inflow",
        "counterparty": {
          "name": "Test CAD Account",
          "account_number": "XXXXXX8002"
        },
        "amount": 1000,
        "fee": 0,
        "net_amount": 1000,
        "running_balance": 187687,
        "reference": "00000000-0000-0000-0000-000000000003",
        "status": "completed",
        "currency": "USD",
        "fx": {
          "source_currency": "USD",
          "destination_currency": "CAD",
          "rate": 1.320641,
          "source_amount": 1000,
          "destination_amount": 1320
        }
      }
    ],
    "pagination": {
      "order": "asc",
      "has_next": false,
      "limit": 100,
      "has_previous": false,
      "next_cursor": null,
      "previous_cursor": null,
      "total_transactions": 13
    }
  }
}

​The Account object

​Create an account

​Request parameters

​Response

​Get an account

​Path parameters

​Query parameters

​Response

​Update an account

​Path parameters

​Request parameters

​Response

​Delete an account

​Path parameters

​Request parameters

​Response

​List accounts

​Query parameters

​Response

​Get account statements

​Path parameters

​Query parameters

​Response

The Account object

Create an account

Request parameters

Response

Get an account

Path parameters

Query parameters

Response

Update an account

Path parameters

Request parameters

Response

Delete an account

Path parameters

Request parameters

Response

List accounts

Query parameters

Response

Get account statements

Path parameters

Query parameters

Response