Port-in Number

1PSIM supports number port-in, allowing you or your customers to transfer an existing phone number from another carrier to the 1PSIM platform. This process ensures continuity for users who want to keep their current number while switching to our service.

To initiate a port-in request, you'll need to collect the following information from the user’s current provider:

• Phone number to be ported

• Account number

• Account PIN or password

• Billing address on file with the current provider

Once submitted via our port-in API or partner portal, the request will be processed within 1–3 business days, depending on the previous carrier’s response time.

⚠️ Note: The phone number must remain active with the current provider until the port is completed.

After a successful port-in, the number will be fully managed under your 1PSIM account, and can be used with any active SIM or eSIM.

Port-in API

POST /subscriber/sim/port/activate/to_active_sim

<Description of the endpoint>

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
esn	string	ESN is at the back of your SIM card
mdn	number	This in the number you want to port-into this SIM
authorizedBy	string	your name and the name the owes the phone number to port in.
firstName	string	your first name
lastName	string	your last name
addressLine1	string	the address you used to register the number with the other provider.
addressLine2	string	the address you used to register the number with the other provider.
city	string	the address you used to register the number with the other provider.
state	string	the address you used to register the number with the other provider.
zip	string	the address you used to register the number with the other provider.
account	string	This is required. This is the account issued by your previous service provider.
password	string	This can be option. This is the password issued by your previous service provider.

Example

curl -X 'POST' \
  'https://1psim.api.lifeline.mobi/subscriber/sim/port/activate/to_active_sim' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer eyJhbGi8' \
  -H 'Content-Type: application/json' \
  -d '{
  "simId": "string",
  "mdn": "string",
  "zipCode": "string",
  "authorizedBy": "string",
  "billing": {
    "firstName": "string",
    "lastName": "string",
    "address": {
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "state": "string",
      "zip": "string"
    }
  },
  "oldProvider": {
    "account": "string",
    "password": "string"
  }
}'

Response

200

{
  "statusCode": 200,
  "message": "Successful"
  }

400

{
  "statusCode": 400,
  "message": "Sim Id validation failed.",
  "error": "FIELD_VALIDATION_FAILED"
}