# Numbers Online Account API **Canonical:** https://apis.io/apis/numbers-online/numbers-online-account-api/ **Provider:** Numbers Online — https://apis.io/providers/numbers-online/ **Base URL:** https://numbers.online/api/v1/mcp **Documentation:** https://numbers.online/docs Numbers Online Account API is one of 17 APIs that [Numbers Online](https://apis.io/providers/numbers-online/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Account. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs. Self-service API account: signup, balance, usage, credit top-ups, and the key lifecycle. Account-management endpoints require an account-level key with the 'manage' use case (every self-service key holds it unless deliberately narrowed; the per-key signing config is exempt). ## Operations (19) | Method | Path | Summary | |---|---|---| | POST | `/api/v1/account/signup` | Sign up for an API key | | GET | `/api/v1/account` | Get account balance and usage | | PATCH | `/api/v1/account` | Update account name / reminder email | | GET | `/api/v1/account/listings/{e164}` | Onboarding state + live trust for an account-owned number | | PUT | `/api/v1/account/listings/{e164}` | Stage a draft profile (or edit a live listing) | | POST | `/api/v1/account/listings/{e164}/verify-checkout` | Mint a verification payment link | | POST | `/api/v1/account/listings/{e164}/logo` | Upload a business logo | | POST | `/api/v1/account/listings/{e164}/documents` | Upload a verification document | | GET | `/api/v1/account/listings/{e164}/reports` | Reports + reviews filed against an owned number | | POST | `/api/v1/account/topup` | Add prepaid credit | | GET | `/api/v1/account/keys` | List API keys | | POST | `/api/v1/account/keys` | Mint a new API key | | GET | `/api/v1/account/keys/{id}` | Read one API key | | PATCH | `/api/v1/account/keys/{id}` | Rename or disable an API key | | POST | `/api/v1/account/keys/{id}/rotate` | Rotate an API key in place | | GET | `/api/v1/account/phones` | List your verified numbers (enrollment inventory) | | PATCH | `/api/v1/account/phones/{e164}` | Enroll / revoke call-provenance (resource form) | | POST | `/api/v1/account/verify-phone/start` | Verify a business number (step 1: send code) | | POST | `/api/v1/account/verify-phone/confirm` | Verify a business number (step 2: confirm code) | ## Machine-readable artifacts (19) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/openapi/numbers-online-account-api-openapi.yml - **Documentation** — https://numbers.online/docs - **APIReference** — https://numbers.online/docs - **GettingStarted** — https://numbers.online/developers - **Guides** — https://numbers.online/docs/integrations - **Authentication** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/authentication/numbers-online-authentication.yml - **Conventions** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/conventions/numbers-online-conventions.yml - **Idempotency** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/conventions/numbers-online-conventions.yml - **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/errors/numbers-online-problem-types.yml - **RateLimits** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/rate-limits/numbers-online-rate-limits.yml - **Plans** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/plans/numbers-online-plans-pricing.yml - **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/lifecycle/numbers-online-lifecycle.yml - **ChangeLog** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/changelog/numbers-online-changelog.yml - **DataModel** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/data-model/numbers-online-data-model.yml - **Conformance** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/conformance/numbers-online-conformance.yml - **AgenticAccess** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/agentic-access/numbers-online-agentic-access.yml - **LLMsTxt** — https://numbers.online/llms.txt - **Pricing** — https://numbers.online/pricing - **SignUp** — https://numbers.online/developers ## Other Numbers Online APIs (12) - [Numbers Online MCP Server](https://apis.io/apis/numbers-online/numbers-online-mcp-server/) - [Numbers Online A2A Agent](https://apis.io/apis/numbers-online/numbers-online-a2a-agent/) - [Numbers Online Community reporting API](https://apis.io/apis/numbers-online/numbers-online-community-reporting-api/) - [Numbers Online Inbound API](https://apis.io/apis/numbers-online/numbers-online-inbound-api/) - [Numbers Online Lookup API](https://apis.io/apis/numbers-online/numbers-online-lookup-api/) - [Numbers Online MCP API](https://apis.io/apis/numbers-online/numbers-online-mcp-api/) - [Numbers Online MSP API](https://apis.io/apis/numbers-online/numbers-online-msp-api/) - [Numbers Online Outbound API](https://apis.io/apis/numbers-online/numbers-online-outbound-api/) - [Numbers Online Parsing API](https://apis.io/apis/numbers-online/numbers-online-parsing-api/) - [Numbers Online PBX API](https://apis.io/apis/numbers-online/numbers-online-pbx-api/) - [Numbers Online Receipts API](https://apis.io/apis/numbers-online/numbers-online-receipts-api/) - [Numbers Online Reference API](https://apis.io/apis/numbers-online/numbers-online-reference-api/) ## Tags Account --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/numbers-online/numbers-online-account-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/numbers-online/.