Troubleshooting
The fastest fixes for the errors you are most likely to hit. Every API error includes a request_id — keep it; it makes support instant.
Authentication
| Symptom | Likely cause & fix |
|---|---|
401 unauthorized | Missing, malformed, or revoked key. Confirm the Authorization: Bearer … header and that the key is active in the dashboard. |
| Worked, then stopped | The key may have been rotated or revoked. Check last used and deploy the current key. |
Validation
| Symptom | Likely cause & fix |
|---|---|
422 on /kyc/start | Invalid userPubkey. Validate it is a correct base58 Solana address before calling. |
400 | Malformed JSON or missing field. Send Content-Type: application/json and check the body shape in the API reference. |
404 on attestation | Unknown ID, or the wallet was never verified. Confirm with GET /kyc/status/:pubkey first. |
Compliance
| Error | Resolution |
|---|---|
attestation_required | The wallet has no valid attestation. Run verification first. |
attestation_expired | Start a new KYC session to renew the attestation. |
rule_violation | Read detail — it names the failed rule (e.g. min_investment_usd_100) — and adjust the request or the rule. |
Rate limits
A 429 means you exceeded your monthly quota. Back off, check usage in the dashboard, and upgrade your plan if you need more headroom. See rate limits.
Still stuck?
Last updated