Skip to main content
Every Finance API resource hangs off a party. Once the hierarchy clicks, the rest of the API is predictable: you create entities top-down, and most operations are scoped to an account.

​
The entities

​
How they’re created

You build top-down, and verification gates the money-movement steps:
1

Create a party

The root identity. KYC/KYB starts after creation — see Account verification.
2

Open an account

Link the party (partyId, or an inline party) and choose the chain. Venly provisions the wallets.
3

Get verified

A Venly admin moves the account to VERIFIED. Until then, money movement is blocked.
4

Add IBANs and move money

Assign a virtual bank account, then transfer or take payment requests.

​
IDs and external IDs

Every entity has a Venly UUID id. You can also set your own externalId on parties and accounts and use it as a shortcut — for example receiverExternalId on a transfer, instead of looking up the Venly UUID.

​
Next steps

Getting started

Build the hierarchy end to end.

Glossary

Definitions for every entity and status.