The ReliaRing API lets you build custom integrations, read and manage phone numbers, calls, messages, and account data directly from your own systems. This guide gets a developer from zero to a first successful request.
Everything you need lives under Developers in the portal (admin access required), which has five areas: Overview, API Keys, Webhooks, API Reference, and Logs & Usage.
Step 1: Create an API key
Your API key is how requests prove they're really from you. To create one, go to Developers → API Keys and generate a key. Copy it immediately, it's shown only once. Full details, including permissions and key types, are in Creating and Managing API Keys.
Live keys begin with rk_live_. Keep the secret safe and never embed it in a public website or app.
Step 2: Find your base URL and endpoints
Open Developers → API Reference for interactive, always-current documentation. It lists the available resources, such as:
- Phone Numbers — list and retrieve numbers on your account
- Messages — list, retrieve, and send SMS/MMS
- Calls — list and retrieve call detail records
- Account — retrieve and update your account details
The Overview page shows your exact API base URL and a ready-to-copy example. You authenticate by sending your key as a bearer token in the Authorization header.
Step 3: Make your first request
A simple request to list your phone numbers looks like this (replace the key with your own):
curl https://api.reliaring.com/v1/phone-numbers \
-H "Authorization: Bearer rk_live_your_key_here"
You'll get back a paginated JSON list. Most list endpoints accept page and limit query parameters (up to 100 per page) and filters like status or type.
Tip: The API Reference page lets you try endpoints right in the browser and can pre-fill one of your API keys, so you can see real responses without writing any code first.
Step 4: Watch it work
As you make requests, Developers → Logs & Usage shows recent calls, response times, and your success rate. It's the fastest way to confirm your integration is behaving and to spot mistakes. See Monitoring API Usage and Rate Limits.
Next steps
- Manage credentials and permissions: Creating and Managing API Keys
- Get real-time event notifications instead of polling: Webhooks and Event Notifications
- See what else connects to ReliaRing: Integrations Overview: Connecting ReliaRing to Your Other Tools