🔑
Authentication
How to authenticate API requests with bearer tokens.
Authentication
Every request to https://api.eveses.com must carry a bearer token:
Authorization: Bearer <your-api-key>
Keys are created in Account → API Keys. Treat them like passwords — they grant full access to your wallet balance and rented numbers.
Rotation
Keys cannot be edited. To rotate, create a new key, swap it into your deployment, then delete the old one. Deletion is immediate.
Scopes
All keys currently grant full account access. Per-scope keys (read-only, rentals-only, etc.) are on the roadmap.
Errors
| HTTP | Meaning |
|---|---|
| 401 | Missing or malformed Authorization |
| 403 | Key revoked or account suspended |
| 429 | Per-key rate limit exceeded |