---
description: "The Noah Business API is organised around REST, using resource-oriented URLs. It accepts JSON-encoded request bodies and returns JSON-encoded responses. All our endpoints follow REST conventions and use standard HTTP response codes, authentication and methods."
title: "NOAH Business API"
---

# NOAH Business API

The Noah Business API is organised around REST, using resource-oriented URLs. It accepts JSON-encoded request bodies and returns JSON-encoded responses. All our endpoints follow REST conventions and use standard HTTP response codes, authentication and methods.

Append `.md` to any endpoint URL below for its parameters, request fields and responses.

## Base URLs

- `https://api.sandbox.noah.com/v1` — V1 Sandbox Server
- `https://api.noah.com/v1` — V1 Production Server

## Authentication

- `X-Api-Key`: Your Noah API key. Required on all requests. See [API Keys](/api-concepts/authentication/api).
- `Api-Signature`: Digitally signed JWT used to verify request authenticity. Optional in sandbox when your API key has no associated signing public key; required in production for all requests. If sent, the signature is always validated. See [Request Signing](/api-concepts/authentication/signing).

## Endpoints

| Method | Path | Endpoint | Markdown |
| --- | --- | --- | --- |
| GET | `/balances` | [Balances](https://docs.noah.com/api-reference/balances) | [balances.md](https://docs.noah.com/api-reference/balances.md) |
| GET | `/channels/{ChannelID}` | [Get Channel by ID](https://docs.noah.com/api-reference/get-channel-by-id) | [get-channel-by-id.md](https://docs.noah.com/api-reference/get-channel-by-id.md) |
| GET | `/channels/{ChannelID}/form` | [Dynamic Form](https://docs.noah.com/api-reference/dynamic-form) | [dynamic-form.md](https://docs.noah.com/api-reference/dynamic-form.md) |
| GET | `/channels/sell` | [Channels](https://docs.noah.com/api-reference/channels) | [channels.md](https://docs.noah.com/api-reference/channels.md) |
| GET | `/channels/sell/countries` | [Countries](https://docs.noah.com/api-reference/countries) | [countries.md](https://docs.noah.com/api-reference/countries.md) |
| POST | `/checkout/payin/crypto` | [Create Crypto Payin Session](https://docs.noah.com/api-reference/create-crypto-payin-session) | [create-crypto-payin-session.md](https://docs.noah.com/api-reference/create-crypto-payin-session.md) |
| GET | `/customers` | [Customers](https://docs.noah.com/api-reference/customers) | [customers.md](https://docs.noah.com/api-reference/customers.md) |
| GET | `/customers/{CustomerID}` | [Customer by ID](https://docs.noah.com/api-reference/customer-by-id) | [customer-by-id.md](https://docs.noah.com/api-reference/customer-by-id.md) |
| PUT | `/customers/{CustomerID}` | [Create/Update Customer](https://docs.noah.com/api-reference/create-update-customer) | [create-update-customer.md](https://docs.noah.com/api-reference/create-update-customer.md) |
| POST | `/help/{CustomerID}` | [Help Desk Session](https://docs.noah.com/api-reference/help-desk-session) | [help-desk-session.md](https://docs.noah.com/api-reference/help-desk-session.md) |
| POST | `/hosted-workflows/bank-deposit-to-onchain-address` | [Convert Fiat to Crypto Session](https://docs.noah.com/api-reference/convert-fiat-to-crypto-session) | [convert-fiat-to-crypto-session.md](https://docs.noah.com/api-reference/convert-fiat-to-crypto-session.md) |
| POST | `/hosted-workflows/onchain-deposit-to-payment-method` | [Convert Crypto to Fiat Session](https://docs.noah.com/api-reference/convert-crypto-to-fiat-session) | [convert-crypto-to-fiat-session.md](https://docs.noah.com/api-reference/convert-crypto-to-fiat-session.md) |
| POST | `/hosted-workflows/recovery` | [Customer Account Recovery Session](https://docs.noah.com/api-reference/customer-account-recovery-session) | [customer-account-recovery-session.md](https://docs.noah.com/api-reference/customer-account-recovery-session.md) |
| POST | `/onboarding/{CustomerID}` | [Create Onboarding Session](https://docs.noah.com/api-reference/create-onboarding-session) | [create-onboarding-session.md](https://docs.noah.com/api-reference/create-onboarding-session.md) |
| POST | `/onboarding/{CustomerID}/prefill` | [Prefill Customer Details](https://docs.noah.com/api-reference/prefill-customer-details) | [prefill-customer-details.md](https://docs.noah.com/api-reference/prefill-customer-details.md) |
| GET | `/onboarding/{CustomerID}/prefill/documents/upload-url` | [Get Document Upload URL](https://docs.noah.com/api-reference/get-document-upload-url) | [get-document-upload-url.md](https://docs.noah.com/api-reference/get-document-upload-url.md) |
| GET | `/payment-methods` | [Payment Methods](https://docs.noah.com/api-reference/payment-methods) | [payment-methods.md](https://docs.noah.com/api-reference/payment-methods.md) |
| GET | `/prices` | [Prices](https://docs.noah.com/api-reference/prices) | [prices.md](https://docs.noah.com/api-reference/prices.md) |
| POST | `/sandbox/fiat-deposit/simulate` | [Simulate Fiat Deposit](https://docs.noah.com/api-reference/simulate-fiat-deposit) | [simulate-fiat-deposit.md](https://docs.noah.com/api-reference/simulate-fiat-deposit.md) |
| GET | `/transactions` | [Transactions](https://docs.noah.com/api-reference/transactions) | [transactions.md](https://docs.noah.com/api-reference/transactions.md) |
| GET | `/transactions/{TransactionID}` | [Transaction by ID](https://docs.noah.com/api-reference/transaction-by-id) | [transaction-by-id.md](https://docs.noah.com/api-reference/transaction-by-id.md) |
| POST | `/transactions/sell` | [Create Sell Transaction](https://docs.noah.com/api-reference/create-sell-transaction) | [create-sell-transaction.md](https://docs.noah.com/api-reference/create-sell-transaction.md) |
| POST | `/transactions/sell/prepare` | [Prepare Sell Transaction](https://docs.noah.com/api-reference/prepare-sell-transaction) | [prepare-sell-transaction.md](https://docs.noah.com/api-reference/prepare-sell-transaction.md) |
| POST | `/transactions/withdraw` | [Create Withdraw Transaction](https://docs.noah.com/api-reference/create-withdraw-transaction) | [create-withdraw-transaction.md](https://docs.noah.com/api-reference/create-withdraw-transaction.md) |
| GET | `/virtual-accounts` | [Virtual Accounts](https://docs.noah.com/api-reference/virtual-accounts) | [virtual-accounts.md](https://docs.noah.com/api-reference/virtual-accounts.md) |
| POST | `/virtual-accounts/{VirtualAccountID}/close` | [Close Virtual Account](https://docs.noah.com/api-reference/close-virtual-account) | [close-virtual-account.md](https://docs.noah.com/api-reference/close-virtual-account.md) |
| POST | `/workflows/bank-deposit-to-onchain-address` | [Convert Fiat to Crypto](https://docs.noah.com/api-reference/convert-fiat-to-crypto) | [convert-fiat-to-crypto.md](https://docs.noah.com/api-reference/convert-fiat-to-crypto.md) |
| POST | `/workflows/onchain-deposit-to-payment-method` | [Onchain Deposit to Fiat Payout](https://docs.noah.com/api-reference/onchain-deposit-to-fiat-payout) | [onchain-deposit-to-fiat-payout.md](https://docs.noah.com/api-reference/onchain-deposit-to-fiat-payout.md) |

## See also

- Guides, and the facts an agent cannot infer from the spec: https://docs.noah.com/llms.txt
- OpenAPI document: https://docs.noah.com/files/oas-schema.generated.json