Phone Numbers

pepe.business lets you purchase and manage dedicated phone numbers in 54 countries. KYC handled by us.

Purchase

POST /v1/phone-numbers/purchase
{
  "country": "FR",
  "type": "mobile",
  "capabilities": ["sms", "voice"]
}

Response:

{
  "phoneNumber": "+33612345678",
  "id": "phn_xxx",
  "monthlyCost": 2.00,
  "currency": "USD",
  "kycUrl": "https://kyc.pepe.business/abc",
  "kycStatus": "pending"
}

KYC

Telecom regulations require KYC for each number. pepe.business handles everything:

1. You receive kycUrl after purchase
2. Share the URL with your end user (or fill it out yourself)
3. pepe.business submits to the regulator
4. Status notified via the phone_number.kyc_approved webhook (usually < 1h in FR)

Number search

GET /v1/phone-numbers/search?country=FR&pattern=06

{
  "available": [
    "+33612345678",
    "+33612345679",
    "+33612345680"
  ]
}

Portability

Import an existing number:

POST /v1/phone-numbers/port-in
{
  "phoneNumber": "+33698765432",
  "currentCarrier": "Orange",
  "accountNumber": "OR-12345",
  "letterOfAuthorization": "data:application/pdf;base64,..."
}

Timeline: 7-15 business days depending on the country.

Availability by country

54 countries supported. See the full list:

GET /v1/phone-numbers/countries

Release

DELETE /v1/phone-numbers/{phoneNumberId}

The number is released immediately. You no longer pay the following month.

Pricing

Per-minute costs (outbound call): from $0.01/min depending on destination.