# ringahuman-com API

**Canonical:** https://apis.io/apis/ringahuman-com/ringahuman-com-api/  
**Provider:** ringahuman-com — https://apis.io/providers/ringahuman-com/  
**Base URL:** https://api.ringahuman.com  
**Documentation:** https://ringahuman.com/docs/sandbox

ringahuman-com API is one of 2 APIs that [ringahuman-com](https://apis.io/providers/ringahuman-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

ringahuman-com API as documented publicly: 17 operations. Contract generated from the documentation by API Evangelist (2026-10-31); not the provider's own document.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/billing` | Get free calls remaining, whether a card is on file, pricing, and whether new tasks will dispatch. |
| POST | `/api/billing/checkout` | Create a checkout link for a billing plan. |
| POST | `/api/dnc` | Put a number on your account's do-not-call list. |
| GET | `/api/hooks` | List all account-wide webhook subscriptions. |
| POST | `/api/hooks` | Create an account-wide webhook subscription to receive outcomes for all tasks. |
| DELETE | `/api/hooks/{id}` | Unsubscribe and remove a webhook subscription. |
| POST | `/api/intake/rah_in_…` | POST /api/intake/rah_in_… |
| GET | `/api/sandbox/tasks` | List sandbox call tasks. |
| POST | `/api/sandbox/tasks` | POST /api/sandbox/tasks |
| GET | `/api/sandbox/tasks/{id}` | Get details of a specific sandbox call task by ID. |
| POST | `/api/sandbox/tasks/{id}/cancel` | Cancel a sandbox call task. |
| POST | `/api/signup` | POST /api/signup |
| GET | `/api/tasks` | Get recent tasks. |
| POST | `/api/tasks` | POST /api/tasks |
| GET | `/api/tasks/{id}` | Retrieve a task to check its outcome and audit trail. |
| POST | `/api/tasks/{id}/cancel` | Pull a call before anyone dials. |
| GET | `/skills/ringahuman/SKILL.md` | Download agent skill instructions for teaching Claude Code when and how to use Ring a Human. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/ringahuman-com/openapi/_ae-authored/ringahuman-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/ringahuman-com/json-schema/ringahuman-com-get-api-sandbox-tasks-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringahuman-com/json-schema/ringahuman-com-get-api-billing-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringahuman-com/json-schema/ringahuman-com-post-api-tasks-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringahuman-com/json-schema/ringahuman-com-post-api-hooks-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringahuman-com/json-schema/ringahuman-com-post-api-sandbox-tasks-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringahuman-com/json-schema/ringahuman-com-post-api-intake-rah-in-request-schema.json

## Other ringahuman-com APIs (1)

- [Ring a Human REST API](https://apis.io/apis/ringahuman-com/ring-a-human-rest-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ringahuman-com/ringahuman-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ringahuman-com/.
