API Reference
Ringhouse API
A REST API over the calls and texts your business already runs on. JSON in, JSON out, over HTTPS.
Base URL
Every endpoint in v1 lives under one host. There is no sandbox host — a test key on the same host is what keeps you out of trouble.
https://api.ringhouse.ai/v1
Authentication
Send your key as a bearer token on every request. Keys are workspace-scoped, and each one carries only the scopes you granted it.
curl https://api.ringhouse.ai/v1/numbers \
-H "Authorization: Bearer rh_live_xxxxxxxx"
Conventions
Ids are UUIDs. Timestamps are ISO 8601 in UTC. Phone numbers are always E.164, in both directions. Lists are cursor-paginated and never renumber underneath you.
Note
v1 is read-heavy by design: you can send messages and manage contacts and webhooks, but calls are read-only for now.
Where to start
- Send a message — one POST, and the text is on its way.
- Read your call history — calls with recordings, summaries and transcripts.
- Subscribe to webhooks — get the reply the moment it lands.
Was this page helpful?