# Phone Inc API

**Canonical:** https://apis.io/apis/phone-inc/phone-inc-api/  
**Provider:** Phone Inc — https://apis.io/providers/phone-inc/  
**Base URL:** https://app.phone.inc  
**Documentation:** https://docs.phone.inc/api/calls

Phone Inc API is published by [Phone Inc](https://apis.io/providers/phone-inc/) 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.

Phone Inc API as documented publicly: 46 operations. Contract generated from the documentation by API Evangelist (2026-10-24); not the provider's own document.

## Operations (46)

| Method | Path | Summary |
|---|---|---|
| GET | `/.well-known/oauth-authorization-server` | authorization, token, revoke, and registration endpoints |
| GET | `/.well-known/oauth-protected-resource` | the protected resource identifier and linked authorization server |
| GET | `/.well-known/oauth-protected-resource/mcp` | the same metadata scoped to the MCP endpoint (resource: https://app.phone.inc/mcp) |
| GET | `/api/v1/activity/unseen` | GET /api/v1/activity/unseen |
| GET | `/api/v1/business_numbers` | Retrieve business numbers (example API call) |
| GET | `/api/v1/calls` | GET /api/v1/calls |
| POST | `/api/v1/calls` | POST /api/v1/calls |
| POST | `/api/v1/calls/$CALL_ID/transfers` | POST /api/v1/calls/$CALL_ID/transfers |
| DELETE | `/api/v1/calls/$CALL_ID/transfers/$TRANSFER_ID` | DELETE /api/v1/calls/$CALL_ID/transfers/$TRANSFER_ID |
| POST | `/api/v1/calls/$CALL_ID/transfers/$TRANSFER_ID/completion` | POST /api/v1/calls/$CALL_ID/transfers/$TRANSFER_ID/completion |
| POST | `/api/v1/calls/${callId}/transfers` | POST /api/v1/calls/${callId}/transfers |
| POST | `/api/v1/calls/${callId}/transfers/${transferId}/completion` | POST /api/v1/calls/${callId}/transfers/${transferId}/completion |
| GET | `/api/v1/calls/0193f4ba-1234-7c00-9e3d-2b2b8a7f1c11` | GET /api/v1/calls/0193f4ba-1234-7c00-9e3d-2b2b8a7f1c11 |
| GET | `/api/v1/calls/active` | GET /api/v1/calls/active |
| GET | `/api/v1/calls/seen` | GET /api/v1/calls/seen |
| POST | `/api/v1/calls/seen` | POST /api/v1/calls/seen |
| PATCH | `/api/v1/company` | PATCH /api/v1/company |
| GET | `/api/v1/inbox` | List grouped previews with GET /api/v1/inbox |
| POST | `/api/v1/inbox` | POST /api/v1/inbox |
| GET | `/api/v1/inbox/{phoneNumber}/activity` | load a number's timeline with GET /api/v1/inbox/:phone_number/activity |
| POST | `/api/v1/inbox/{phoneNumber}/seen` | mark observed items seen with POST /api/v1/inbox/:phone_number/seen |
| GET | `/oauth/authorize` | Redirect the user to authorize the client |
| POST | `/oauth/register` | POST /oauth/register |
| POST | `/oauth/revoke` | Invalidate an access or refresh token |
| POST | `/oauth/token` | Exchange authorization code or refresh token for access token |
| GET | `/v1/activity/unseen` | Unseen activity |
| GET | `/v1/business_numbers/{businessNumberId}/texting_settings` | Texting and inbox - Phone.inc documentation |
| PATCH | `/v1/business_numbers/{businessNumberId}/texting_settings` | Texting and inbox - Phone.inc documentation |
| GET | `/v1/calls` | List recent calls |
| GET | `/v1/calls/{id}` | Retrieve a call |
| POST | `/v1/calls/{id}/transfers` | Start a warm transfer |
| DELETE | `/v1/calls/{id}/transfers/{transferId}` | Cancel a warm transfer |
| POST | `/v1/calls/{id}/transfers/{transferId}/completion` | Complete a warm transfer |
| POST | `/v1/calls/seen` | Mark a conversation seen |
| GET | `/v1/company` | Retrieve the company |
| PATCH | `/v1/company` | Update the company |
| GET | `/v1/inbox` | List the inbox |
| GET | `/v1/inbox/{phoneNumber}/activity` | List activity |
| POST | `/v1/inbox/{phoneNumber}/seen` | Mark activity seen |
| GET | `/v1/messages/{id}` | Retrieve a text |
| POST | `/v1/messages/{id}/retries` | Retry a failed text |
| GET | `/v1/text_snippets` | List snippets |
| POST | `/v1/text_snippets` | Create a snippet |
| DELETE | `/v1/text_snippets/{id}` | Texting and inbox - Phone.inc documentation |
| GET | `/v1/text_snippets/{id}` | Retrieve a snippet |
| PATCH | `/v1/text_snippets/{id}` | Update a snippet |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/phone-inc/openapi/_ae-authored/phone-inc-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/phone-inc/json-schema/phone-inc-get-api-v1-calls0193-f4-ba12347-c009-e3-d2-b2-b8-a7-f1-c11-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/phone-inc/json-schema/phone-inc-get-v1-company-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/phone-inc/json-schema/phone-inc-patch-v1-company-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/phone-inc/json-schema/phone-inc-post-api-v1-calls-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/phone-inc/json-schema/phone-inc-get-api-v1-calls-active-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/phone-inc/json-schema/phone-inc-get-v1-calls-id-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/phone-inc/apis.yml

---

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