API Reference — Overview
Base URL: https://api.thiqwave.com/api. All paths below are /v1/... under $BASE_URL.
There is one base URL for both environments — your API key decides whether a call runs against TEST or LIVE. See Environments.
Auth matrix
| Surface | Auth | Header |
|---|---|---|
customers, beneficiaries, transactions/*, payments, webhooks, logs, customers/:id/accounts, transactions/quote* | API key | X-API-Key: $THIQWAVE_API_KEY |
pricing/*, partner-wallets, applications/*, auth/me | register | keys | lookup-email | Bearer token (Dashboard) | Authorization: Bearer $PARTNER_TOKEN |
GET wallets/validate | Public — no credential required | — |
/admin/*, admin routes, provider-callback receivers, internal services | Never published | — |
Headers
| Header | Required | Notes |
|---|---|---|
X-API-Key | server-to-server | your application secret |
Authorization | dashboard | Bearer <jwt> |
Idempotency-Key | money-moving POST | required on POST /v1/transactions, POST /v1/payments |
X-Request-ID | optional | echoed as correlation_id |
Content-Type | bodies | application/json |
Conventions
- IDs: UUIDv7 / NanoID external IDs; internal DB IDs never exposed.
- Money: always string; ledger/quote amounts are integer minor units (
*_minor). - Timestamps: ISO 8601 UTC.
- Pagination:
limit(1–100, default 25) +cursor; response{ "data": [...], "next_cursor": "…" | null }. - Errors:
{ "error": { code, message, correlation_id, details } }— see Errors.
Resources
Customers · Beneficiaries · Quotes · Transactions · Payments · Webhooks · Wallets · Pricing · Accounts · Logs