---
title: "API Reference"
url: "/api/"
index: "/llms.txt"
---

# API Reference

## About this API

The Nodu API provides customer, transfer, account and balance operations over HTTPS.
Requests and responses use JSON; document uploads use multipart form data.
Each operation below lists its parameters, request fields, responses and errors.
See the [guides](/guides/index.md) for integration workflows.

## Authentication

Send an API key for the selected environment with every request:

```http
Authorization: Bearer <your-api-key>
```

Use sandbox keys with `https://api.sandbox.nodu.fi` and production keys with `https://api.nodu.fi`.
Keep keys on your backend. A missing or invalid key returns `401`; a request that is not allowed returns `403`.
See [Authentication](/guides/api-basics/authentication/index.md) for details.

## Servers

- Production: `https://api.nodu.fi`
- Sandbox: `https://api.sandbox.nodu.fi`

## OpenAPI document

The whole reference in one file: [/default.json](/default.json), or [/default.yaml](/default.yaml) in YAML.

## Resources

- [Customers](/api/tag/customers.md): Create and retrieve customers, manage applications, and activate payment channels.
- [Transfers](/api/tag/transfers.md): Create, retrieve, update and cancel transfers.
- [Exchange Rates](/api/tag/exchange-rates.md): Retrieve indicative exchange rates.
- [Quotes](/api/tag/quotes.md): Create, retrieve and update a quote containing transfer amounts, fees and an expiry time.
- [Wallets](/api/tag/wallets.md): Create and retrieve Nodu wallets and their balances.
- [Relays](/api/tag/relays.md): Create and retrieve relays, which provide reusable deposit instructions for a customer.
- [External Accounts](/api/tag/external-accounts.md): Register and maintain external accounts and counterparties.
- [VASPs](/api/tag/vasps.md): Look up exchanges and custodians that can hold hosted crypto wallets.
- [Beneficiaries (Deprecated)](/api/tag/beneficiaries-deprecated.md): Deprecated beneficiary operations.
- [Developer](/api/tag/developer.md): Retrieve company account information.
- [Webhooks](/api/tag/webhooks.md): Event payload schemas and examples.
