# Venly Finance

## Docs

- [Add a party role](https://docs.venlyfinance.com/api-reference/Finance-API/accounts/add-a-party-to-an-account.md): Link an existing party to an account in a given role.
- [Create an account](https://docs.venlyfinance.com/api-reference/Finance-API/accounts/create-a-new-account.md): Open an account and provision its wallet on the chosen chain.
- [Get an account](https://docs.venlyfinance.com/api-reference/Finance-API/accounts/get-account-details.md): Retrieve a single account by ID.
- [List accounts](https://docs.venlyfinance.com/api-reference/Finance-API/accounts/list-all-accounts.md): Page through the accounts in your organisation.
- [List party roles](https://docs.venlyfinance.com/api-reference/Finance-API/accounts/list-party-roles-for-an-account.md): List the parties linked to an account and the role each one holds.
- [Remove a party role](https://docs.venlyfinance.com/api-reference/Finance-API/accounts/remove-a-party-from-an-account.md): Unlink a party from an account.
- [Get wallet allowances](https://docs.venlyfinance.com/api-reference/Finance-API/allowances/get-wallet-token-allowances.md): Read the ERC-20 token allowances granted from a self-custody wallet.
- [Create a pay-in session](https://docs.venlyfinance.com/api-reference/Finance-API/fiat-to-crypto-payment-sessions/create-a-fiat-to-crypto-payment-session.md): Start a hosted fiat-to-crypto pay-in and get a payment URL.
- [Create a party](https://docs.venlyfinance.com/api-reference/Finance-API/parties/create-a-new-party.md): Onboard an individual or organisation — the root entity that holds accounts.
- [Delete a party](https://docs.venlyfinance.com/api-reference/Finance-API/parties/delete-party.md): Permanently delete a party that has no linked accounts.
- [Get a party](https://docs.venlyfinance.com/api-reference/Finance-API/parties/get-party-details.md): Retrieve a single party by ID, including verification status and address.
- [List parties](https://docs.venlyfinance.com/api-reference/Finance-API/parties/list-all-parties.md): Page through the parties (individuals and organisations) in your organisation.
- [Update a party](https://docs.venlyfinance.com/api-reference/Finance-API/parties/update-party-details.md): Update an existing party's name, VAT number, or address.
- [Create a payment request by card provider](https://docs.venlyfinance.com/api-reference/Finance-API/payment-requests/create-payment-request-by-card-provider.md): Create a payment request, resolving the account from a card-provider reference.
- [Create a payment request](https://docs.venlyfinance.com/api-reference/Finance-API/payment-requests/create-payment-request-for-account.md): Request settlement of a payment from an account's crypto balance.
- [Reverse a payment request](https://docs.venlyfinance.com/api-reference/Finance-API/payment-requests/reverse-a-payment-request.md): Unwind a reserved payment request and return all escrowed funds to the account.
- [Reverse a payment request by reference](https://docs.venlyfinance.com/api-reference/Finance-API/payment-requests/reverse-a-payment-request-by-reference.md): Reverse a payment request located by its card-provider reference.
- [Settle a payment request](https://docs.venlyfinance.com/api-reference/Finance-API/payment-requests/settle-a-payment-request.md): Finalize a reserved payment request — move funds from escrow to the company's settlement wallet.
- [Settle a payment request by reference](https://docs.venlyfinance.com/api-reference/Finance-API/payment-requests/settle-a-payment-request-by-reference.md): Settle a payment request located by its card-provider reference.
- [Update a payment request](https://docs.venlyfinance.com/api-reference/Finance-API/payment-requests/update-a-payment-request.md): Set a new authorized amount on a reserved payment request.
- [Get permit messages](https://docs.venlyfinance.com/api-reference/Finance-API/permits/get-permit-messages.md): Fetch the EIP-712 typed-data messages to sign for gasless token approvals.
- [Submit a signed permit](https://docs.venlyfinance.com/api-reference/Finance-API/permits/submit-signed-permit.md): Submit an EIP-712 signature to grant a gasless token allowance.
- [Create a crypto transfer](https://docs.venlyfinance.com/api-reference/Finance-API/transfers/create-crypto-transfer.md): Send a crypto transfer between two accounts.
- [Create a fiat transfer](https://docs.venlyfinance.com/api-reference/Finance-API/transfers/create-fiat-transfer.md): Send a fiat-denominated transfer between two accounts.
- [Get a transfer](https://docs.venlyfinance.com/api-reference/Finance-API/transfers/get-transfer-details.md): Retrieve a single transfer by ID.
- [List transfers](https://docs.venlyfinance.com/api-reference/Finance-API/transfers/list-transfers-for-account.md): Page through an account's transfers — sent and received, fiat and crypto.
- [Create a virtual bank account](https://docs.venlyfinance.com/api-reference/Finance-API/virtual-bank-accounts/create-a-virtual-bank-account.md): Assign a virtual IBAN to an account for fiat pay-ins.
- [Get a virtual bank account](https://docs.venlyfinance.com/api-reference/Finance-API/virtual-bank-accounts/get-virtual-bank-account-details.md): Retrieve a single virtual bank account by ID.
- [List virtual bank accounts](https://docs.venlyfinance.com/api-reference/Finance-API/virtual-bank-accounts/list-virtual-bank-accounts.md): List the virtual IBANs assigned to an account.
- [List wallets](https://docs.venlyfinance.com/api-reference/Finance-API/wallets/list-wallets-for-an-account.md): List an account's wallets with their per-asset balances.
- [Get bank account configuration](https://docs.venlyfinance.com/api-reference/Fundflow-API/bank-account-configuration/get-bank-account-configuration.md): Retrieve enabled bank account types, supported countries, and currencies.
- [Get supported blockchain networks](https://docs.venlyfinance.com/api-reference/Fundflow-API/blockchain-networks/get-supported-blockchain-networks.md): Retrieve the blockchain networks supported for crypto operations.
- [Whitelist a company bank account](https://docs.venlyfinance.com/api-reference/Fundflow-API/company-bank-accounts/create-a-company-bank-account.md): Register a company bank account for fiat settlement in ramp requests.
- [Get company bank account by ID](https://docs.venlyfinance.com/api-reference/Fundflow-API/company-bank-accounts/get-company-bank-account-by-id.md): Fetch details for a specific company bank account.
- [List company bank accounts](https://docs.venlyfinance.com/api-reference/Fundflow-API/company-bank-accounts/list-company-bank-accounts.md): Retrieve your company bank accounts, with optional filtering.
- [Update company bank account](https://docs.venlyfinance.com/api-reference/Fundflow-API/company-bank-accounts/update-company-bank-account.md): Update the name of a company bank account.
- [Whitelist a company wallet](https://docs.venlyfinance.com/api-reference/Fundflow-API/company-wallets/create-a-company-wallet.md): Register a company crypto wallet for use in ramp requests.
- [Get company wallet by ID](https://docs.venlyfinance.com/api-reference/Fundflow-API/company-wallets/get-company-wallet-by-id.md): Fetch details for a specific company wallet.
- [List company wallets](https://docs.venlyfinance.com/api-reference/Fundflow-API/company-wallets/list-company-wallets.md): Retrieve your company crypto wallets, filterable by status, chain, and address.
- [Update company wallet](https://docs.venlyfinance.com/api-reference/Fundflow-API/company-wallets/update-company-wallet.md): Update the description of a company wallet.
- [Get company details](https://docs.venlyfinance.com/api-reference/Fundflow-API/company/get-company-details.md): Retrieve your company's details and KYB status.
- [Get crypto currency by ID](https://docs.venlyfinance.com/api-reference/Fundflow-API/crypto-currencies/get-crypto-currency-by-id.md): Fetch details for a specific cryptocurrency.
- [List all crypto currencies](https://docs.venlyfinance.com/api-reference/Fundflow-API/crypto-currencies/list-all-crypto-currencies.md): Retrieve the cryptocurrencies supported for ramp operations.
- [Get deposit wallets](https://docs.venlyfinance.com/api-reference/Fundflow-API/deposit-wallets/list-deposit-wallets.md): Retrieve Venly deposit wallet addresses for verification and off-ramp settlement.
- [Calculate fee for a ramp request](https://docs.venlyfinance.com/api-reference/Fundflow-API/fees/calculate-fee-for-a-ramp-request.md): Preview the fee for a given ramp amount before creating a request.
- [Get company fee configuration](https://docs.venlyfinance.com/api-reference/Fundflow-API/fees/get-company-fee-configuration.md): Retrieve your company's fee tiers.
- [Get fiat currency by ID](https://docs.venlyfinance.com/api-reference/Fundflow-API/fiat-currencies/get-fiat-currency-by-id.md): Fetch details for a specific fiat currency.
- [List all fiat currencies](https://docs.venlyfinance.com/api-reference/Fundflow-API/fiat-currencies/list-all-fiat-currencies.md): Retrieve the fiat currencies supported for ramp operations.
- [Approve a ramp request](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/approve-a-ramp-request.md): Approve a pending request to move it to AWAITING_FUNDS.
- [Cancel a ramp request](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/cancel-a-ramp-request.md): Cancel your own pending request before it is approved.
- [Create a ramp request](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/create-a-new-ramp-request.md): Start an on-ramp (fiat to crypto) or off-ramp (crypto to fiat) request.
- [Edit the amount of a ramp request](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/edit-the-amount-of-a-ramp-request.md): Update the incoming amount of a pending ramp request.
- [Export ramp requests](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/export-ramp-requests.md): Download all your ramp requests as a file for accounting and auditing.
- [Get available off-ramp currency pairs](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/get-available-off-ramp-currency-pairs.md): List supported crypto-to-fiat currency pairs for off-ramp requests.
- [Get available on-ramp currency pairs](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/get-available-on-ramp-currency-pairs.md): List supported fiat-to-crypto currency pairs for on-ramp requests.
- [Get ramp request by ID](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/get-ramp-request-by-id.md): Fetch full details, amounts, status, and event history for one ramp request.
- [Initiate an off-ramp request with transaction hash](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/initiate-a-ramp-request-with-transaction-hash.md): Mark an off-ramp request as initiated by submitting its on-chain transaction hash.
- [List all ramp requests](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/list-all-ramp-requests.md): Retrieve a paginated, filterable list of your on-ramp and off-ramp requests.
- [Reject a ramp request](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/reject-a-ramp-request.md): Reject a pending request created by a Manager.
- [Update transaction hash](https://docs.venlyfinance.com/api-reference/Fundflow-API/ramp-requests/update-transaction-hash.md): Add or update the blockchain transaction hash for a ramp request.
- [Delete a company user](https://docs.venlyfinance.com/api-reference/Fundflow-API/users/delete-a-company-user.md): Permanently remove a user from your company.
- [Invite a user to the company](https://docs.venlyfinance.com/api-reference/Fundflow-API/users/invite-a-user-to-the-company.md): Send an email invitation for a new user to join your company.
- [List company users](https://docs.venlyfinance.com/api-reference/Fundflow-API/users/list-company-users.md): Retrieve all users in your company with their roles and status.
- [Update user role](https://docs.venlyfinance.com/api-reference/Fundflow-API/users/update-user-role.md): Change a company user's role.
- [Update user status](https://docs.venlyfinance.com/api-reference/Fundflow-API/users/update-user-status.md): Enable or disable a company user account.
- [Finance API](https://docs.venlyfinance.com/api-reference/introduction.md): Embedded financial infrastructure — parties, accounts, wallets, IBANs, and transfers.
- [Authentication](https://docs.venlyfinance.com/getting-started/authentication.md): Obtain and use OAuth2 Bearer tokens for the Fundflow API and Finance API.
- [API Conventions](https://docs.venlyfinance.com/getting-started/conventions.md): Idempotency, pagination, and versioning rules that apply to every Venly API endpoint.
- [Endpoints & URLs](https://docs.venlyfinance.com/getting-started/endpoints.md): All base URLs and authentication endpoints for Fundflow API and Finance API — staging and production.
- [Quick Start](https://docs.venlyfinance.com/getting-started/quickstart.md): Authenticate, send a request, and read the response — your first Venly API call in under 5 minutes.
- [Card Program Setup](https://docs.venlyfinance.com/guides/card-issuance/card-program-setup.md): Prepare a cardholder account so card authorizations can reserve and settle funds — the Venly-managed and self-custody flows side by side.
- [Card Issuance (Coming Soon)](https://docs.venlyfinance.com/guides/card-issuance/introduction.md): White-label Mastercard debit cards linked to USDC wallets
- [Compliance Engine (Coming Soon)](https://docs.venlyfinance.com/guides/compliance/introduction.md): Automated screening, transaction monitoring, and regulatory reporting across all payment rails
- [Finance API changelog](https://docs.venlyfinance.com/guides/finance/changelog.md): Releases and updates to the Venly Finance API — new endpoints, parameters, supported chains, and improvements.
- [Data model](https://docs.venlyfinance.com/guides/finance/data-model.md): How parties, accounts, wallets, and virtual bank accounts relate — the object hierarchy behind every Finance API call.
- [Errors & error codes](https://docs.venlyfinance.com/guides/finance/errors.md): The response envelope, the HTTP status and error code each failure returns, and how to handle them.
- [Getting started](https://docs.venlyfinance.com/guides/finance/getting-started.md): Create a party, open an account, get it verified, and issue an IBAN — with managed and self-custody examples.
- [Glossary](https://docs.venlyfinance.com/guides/finance/glossary.md): Definitions for parties, accounts, party roles, virtual bank accounts, custodial wallets, transfers, permits, and other Finance API concepts.
- [Safe retries with idempotency keys](https://docs.venlyfinance.com/guides/finance/idempotency.md): Send a unique key with each request so a retry never creates a duplicate.
- [Integration Walkthrough](https://docs.venlyfinance.com/guides/finance/integration-walkthrough.md): Onboard a user, get their account verified, fund it, and send a transfer using the Finance API.
- [Account verification](https://docs.venlyfinance.com/guides/finance/kyc-verification.md): Why a new account can't move money yet, and how it becomes verified.
- [Venly-managed vs self-custody](https://docs.venlyfinance.com/guides/finance/managed-vs-self-custody.md): Two ways an account's wallet is controlled — and what changes for your integration.
- [Payment requests](https://docs.venlyfinance.com/guides/finance/payment-requests.md): Reserve money from an account, then settle, reverse, or adjust it — with a per-step breakdown.
- [Approving transfers without gas](https://docs.venlyfinance.com/guides/finance/permits-and-allowances.md): How self-custody accounts let Venly move their tokens — permits, allowances, and wallet activation.
- [Supported chains & assets](https://docs.venlyfinance.com/guides/finance/supported-chains-and-assets.md): The blockchain networks, stablecoins, and fiat currencies the Finance API supports, and how they relate.
- [Transfers](https://docs.venlyfinance.com/guides/finance/transfers.md): Move funds from one account to another — fiat-denominated or crypto-denominated — and track them to completion.
- [Versioning & safe updates](https://docs.venlyfinance.com/guides/finance/versioning.md): Use the version field so two edits never silently overwrite each other.
- [Virtual bank accounts (IBANs)](https://docs.venlyfinance.com/guides/finance/virtual-bank-accounts.md): Assign an IBAN to an account to receive fiat by SEPA, auto-converted to crypto — and how the reference code routes the funds.
- [Wallets & balances](https://docs.venlyfinance.com/guides/finance/wallets.md): The custodial wallets behind every account — the two-wallet model, balance fields, and how funds get reserved.
- [Multi-Rail Routing (Coming Soon)](https://docs.venlyfinance.com/guides/multi-rail-routing/introduction.md): Intelligent payment routing across SEPA, SWIFT, stablecoins, and local rails for optimal speed
- [Account Management](https://docs.venlyfinance.com/guides/payments/accounts.md): Configure company bank accounts and crypto wallets that source and receive funds during Fundflow ramp requests.
- [API Authentication](https://docs.venlyfinance.com/guides/payments/authentication.md): Authenticate with Venly Fundflow API using OAuth2 client credentials
- [Dashboard](https://docs.venlyfinance.com/guides/payments/dashboard.md): Fundflow API architecture — resource model, data types, response envelope, and the integration patterns that make production calls reliable.
- [Fee Structure](https://docs.venlyfinance.com/guides/payments/fees.md): How Fundflow ramp fees are calculated — fee tiers, exchange-rate spreads, the calculate-fee endpoint, and what shows up on the invoice.
- [Getting Started with Fundflow](https://docs.venlyfinance.com/guides/payments/getting-started.md): End-to-end guide to integrate Fundflow — authentication, creating ramp requests, settlement, and going live with the on-ramp/off-ramp API.
- [Glossary](https://docs.venlyfinance.com/guides/payments/glossary.md): Definitions for ramp requests, fees, KYC/KYB, on-ramp, off-ramp, and other Fundflow concepts you'll see in the docs and dashboard.
- [Quick Reference Guide](https://docs.venlyfinance.com/guides/payments/quick-reference.md): Cheat sheet for Fundflow — base URLs, auth flow, ramp request lifecycle, and the most-used endpoints on a single page.
- [Security & Best Practices](https://docs.venlyfinance.com/guides/payments/security.md): Credential management, token security, and defensive patterns for Fundflow API integrations
- [Transactions](https://docs.venlyfinance.com/guides/payments/transactions.md): Create, approve, and track Fundflow ramp requests — the lifecycle of an on-ramp or off-ramp transaction from initiation to settlement.
- [Troubleshooting](https://docs.venlyfinance.com/guides/payments/troubleshooting.md): API error codes, common integration failures, and how to fix them
- [Treasury Yield (Coming Soon)](https://docs.venlyfinance.com/guides/treasury-yield/introduction.md): Earn yield on idle stablecoin reserves through curated DeFi and tokenized vaults
- [Venly Finance Developer Documentation](https://docs.venlyfinance.com/index.md): Build with stablecoin settlement orchestration. One API. Multiple rails. Your economics.

## OpenAPI Specs

- [Finance-API-Specs](https://docs.venlyfinance.com/api-reference/Finance-API-Specs.yaml)
- [Fundflow-API](https://docs.venlyfinance.com/api-reference/Fundflow-API.yaml)
- [openapi](https://docs.venlyfinance.com/api-reference/openapi.json)

## Optional

- [Blog](https://venlyfinance.com/blog)
- [Support](https://venlyfinance.com/contact)