Documentation

Everything about using NumberOTP as a customer, running a white-label reseller business on it, or integrating the API directly.

Dashboard & Account Pages

Every page in your account, what it does, and how to find it — from buying your first number to managing sub-users.

Browse the guide →

White-Label & Custom Domain

Brand the panel your customers see, drop your own support email, and connect your own domain step by step.

Set up white-label →

Public & Account API

REST endpoints for prices, activations, rentals, and webhooks. Authenticate with a Bearer API key.

View API reference →

Reseller API Reference

Programmatic sub-user management, markup, payouts, and reseller webhooks for building your own frontend.

View reseller API →

Interactive Playground

Test endpoints instantly in your browser using the built-in Scalar API environment.

Open playground →

Error Codes

Every machine-readable error code the API returns, what it means, and what to do about it.

View error codes →

SDKs: TypeScript, Python, Go & PHP

Install with npm, pip, go get or Composer, then buy a number and get its code in one call — retries and refunds handled.

Start with an SDK →

CLI (notp)

Numbers and codes from your terminal, scripts and CI. Install with Homebrew or one curl command.

Install the CLI →

MCP for AI Agents

Connect Claude, Cursor, Codex and other agents so they can verify accounts within a budget you set.

Connect an agent →

Browser Extension

Chrome, Edge and Firefox: get a number for the site you are on and have the number and SMS code filled in.

Use the extension →

1Quick Start

Create an account — every new signup gets a small free credit balance, no card required. Once signed in, your dashboard lets you pick a service and country and get a number instantly — see the Dashboard guide for what every page does.

To integrate programmatically instead: generate an API key from Developer → API Keys, then authenticate with:

Authorization: Bearer notp_1234567890abcdef

Easier still: use an official SDK (npm install numberotp, pip install numberotp, go get github.com/numberotp/numberotp-go, composer require numberotp/numberotp) — see the SDK guide, or the CLI for your terminal.

Full endpoint list, request/response shapes, and webhook signature verification are in the API Reference.

2Running a White-Label Reseller Business

Apply from the Reseller Program page. Once approved, you get a reseller panel (sub-users, markup, payouts) and a public signup link your customers use to create accounts under your business — branded with your name, logo, color, and support email instead of NumberOTP's, and optionally served on your own domain.

Set all of this up in Reseller → Settings — the full walkthrough, including exactly which DNS records to add for a custom domain, is in White-Label & Custom Domain.