Developers

Partner API

Buy real Verizon, AT&T, and T-Mobile port numbers from your software. Every request uses live inventory and debits your PortPilot dealer wallet.

Base URL

https://portpilot-production.up.railway.app

API key

Keys are issued by PortPilot for your funded dealer account. There is no public demo key — contact us to get yours.

Send as Authorization: Bearer pp_live_… or X-Api-Key.

Buy a number

curl -s -X POST https://portpilot-production.up.railway.app/v1/numbers \
  -H "Authorization: Bearer pp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{"carrier":"verizon","zip":"90210","quantity":1}'

quantity is 1–100 per request. Orders often return processing first. Poll GET /v1/numbers/:id until phone, account, and PIN are present.

Endpoints

  • GET /v1/me — balance + key info
  • GET /v1/carriers — verizon / att / tmobile prices
  • POST /v1/numbers — purchase (wallet billed)
  • GET /v1/numbers / GET /v1/numbers/:id — list / status

Need a key?

Fund your dealer wallet in the portal, then ask PortPilot for an API key. We will send documentation and your secret key privately.

Contact us