PressOne eSIM Developer Platform
  1. Endpoints
PressOne eSIM Developer Platform
  • OVERVIEW
    • Introduction
    • Attribute descriptions
    • FAQ
    • User journeys
      • Top-up Journey
      • Purchase Journey
    • Guides
      • eSIM installation methods for API Partners
      • How to generate the QR code for an eSIM
  • REST API
    • Data / Data + Voice + SMS eSIM
      • Introduction
      • Error handling
      • Endpoints
        • Authenticate
          • Request access token
        • Check balance
          • Get balance
        • Compatible devices
          • Get compatible device lite list
        • Browse packages
          • Get packages
        • Place order
          • Submit order
        • Install eSIM
          • Get eSIM
          • Get installation instructions
        • Monitor usage
          • Get usage (data, text & voice)
        • Place top up order
          • Get top-up package list
          • Submit top-up order
        • Manage orders
          • Get order list
          • Get order
        • Manage eSIMs
          • Get eSIMs list
          • Get eSIM package history
    • Voice-only eSIM
      • Getting Started
      • Error handling
      • Endpoints
        • List Available Numbers
          GET
        • Claim Number
          POST
        • Renew Number
          POST
        • List User
          GET
  1. Endpoints

Claim Number

POST
/api/third-party/partner/claim-number/
Call this endpoint to claim an available phone number for a user. This endpoint registers a user with PressOne and assigns them a phone number from the available pool

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://prod.your-api-server.com/api/third-party/partner/claim-number/' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "business_name": "Example Corp",
  "dob": "1990-01-15",
  "email": "user@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "mobile": "+2348012345678",
  "nin": "12345678901",
  "pressone_number": "+2348023456789",
  "is_free_trial": false
}'
Response Response Example
{
  "message": "string",
  "success": true,
  "data": null
}
Modified at 2025-11-16 11:01:12
Previous
List Available Numbers
Next
Renew Number
Built with