# 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

<mark style="color:green;">`POST`</mark> `/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**

{% tabs %}
{% tab title="200" %}

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

{% endtab %}

{% tab title="400" %}

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

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.1psim.com/port-in-number.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.