ringbeta Developer API
Rent phone numbers, manage the mailboxes you own, and purchase eSIM data plans programmatically. All responses are JSON.
Quick Start
1
Get your API Token
Log in to your ringbeta account, go to /dash/account, and copy your API Token (or click Reset to generate a new one).
2
Exchange it for a JWT
Call POST https://api.ringbeta.com/api/v1/auth/token with your API Token to get a JWT valid for 7 days.
3
Call the API
Send Authorization: Bearer <JWT> on every request below.
Error Codes
| HTTP Status | Meaning |
|---|---|
400 | Invalid or missing parameters |
401 | Missing/invalid/expired JWT, or your API Token was reset (all previously issued JWTs are invalidated immediately) |
404 | The requested resource does not exist or does not belong to your account |
405 | Wrong HTTP method for this endpoint |
429 | Rate limit exceeded, see retry_after in the response |
