Authentication
Base URL
Section titled “Base URL”https://api.nuez.app/v1Bearer token
Section titled “Bearer token”Include your API key as a Bearer token in every request:
curl https://api.nuez.app/v1/balance \ -H "Authorization: Bearer nz_sk_live_YOUR_KEY_HERE"Key types
Section titled “Key types”| Prefix | Environment |
|---|---|
nz_sk_live_... | Production — real money moves |
nz_sk_test_... | Sandbox — no real money |
Use nz_sk_test_... during development. The sandbox behaves identically to production, including the approval flow (WhatsApp messages are sent to a test number, not your real phone).
Error responses
Section titled “Error responses”| Status | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key |
403 | scope_denied | Key exists but lacks the required scope |