> For the complete documentation index, see [llms.txt](https://doc.1psim.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.1psim.com/public-api/renew-sim.md).

# Renew SIM

After a SIM expires, you have a **7-day grace period** to renew it. During this time, the phone number remains reserved for your account. If the SIM is **not renewed within 7 days**, the phone number will be **permanently released**, and renewal will no longer be possible.

To successfully renew a SIM, your account must have **sufficient balance** to cover the renewal cost. If the balance is insufficient, the renewal request will fail.

## Renew SIM

<mark style="color:green;">`POST`</mark> `/subscriber/sim/{esn}/plan/renew`

ESN is the number at the back of your SIM

**Headers**

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

**Body**

| Name           | Type   | Description                                  |
| -------------- | ------ | -------------------------------------------- |
| paymentGateway | string | fixed value "balance"                        |
| planPricingId  | string | This is the duration you want to renew with. |

**Example**

```
curl -X 'POST' \
  'https://1psim.api.lifeline.mobi/subscriber/sim/89898989898989/plan/renew' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "paymentGateway": "balance",
  "planPricingId": "string"
}'
```

**Response**

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

```json
{
  "statusCode": 200,
  "message": "Success Renew"
}
```

{% endtab %}

{% tab title="401" %}

```json
{
  "statusCode": 401,
  "message": "Unauthorized"
}
```

{% endtab %}
{% endtabs %}