VALR Business APIs
APIs for building on VALR's business payments platform — getting paid (collections), funding, disbursements, scheduled withdrawals and settlements. The reference is organised by feature, so you can find what you need without knowing which backend service serves it.
The APIs we expose
| API | Who it's for | Auth | Where | Status |
|---|---|---|---|---|
| Web API | The business dashboard / frontend | Logged-in session | api-dev.valr.world/institution/payments/* | Live |
| v1 API | Programmatic / partner integrations | API key (not a session) | api-dev.valr.world (same host, key-based) | Coming soon |
| Admin API | VALR operators | Session + operator role | Internal admin surface | Live |
| Internal API | Service-to-service | HMAC-signed | Not publicly routable | Live |
The Web API and the forthcoming v1 API are the same endpoints — the difference is how you authenticate: the Web API rides the logged-in user's session (what the dashboard uses today), while v1 will let partners call the same surface with an API key. Both are documented under API Reference.
Start here
- API Reference — the public, frontend-facing endpoints, grouped by feature: Getting paid, Funding records, Scheduled withdrawals, Settlements, Disbursements, Payout history, Account balances and Configuration.
- Admin API — operator endpoints (require an operator role).
- Internal API — service-to-service endpoints.
- How these docs work — where the specs come from, the
/institutiongateway, and how to regenerate them.
Prefer a raw spec? Download the Web API OpenAPI spec — one file covering the whole Web API, ready for Postman or code generation.