> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telewing247.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set rental status

> Update the status of a worldwide rental

Updates the status of a worldwide virtual number rental.

## Endpoint

```http theme={null}
POST /virtual-numbers/worldwide/status
```

## Body parameters

| Parameter       | Type   | Required | Description                                   |
| --------------- | ------ | -------- | --------------------------------------------- |
| `activation_id` | string | Yes      | Activation ID returned from the rent request. |
| `status`        | string | Yes      | New status code. See values below.            |

### Status codes

| Code | Meaning           |
| ---- | ----------------- |
| `1`  | Retry / ready     |
| `2`  | Cancel            |
| `3`  | Complete / finish |
| `8`  | Ready             |

## Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.telewing247.com/api/api/v1/public/virtual-numbers/worldwide/status \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer ak_YOUR_API_KEY_HERE" \
    -d '{
      "activation_id": "tigersms-17831000-123456",
      "status": "2"
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.telewing247.com/api/api/v1/public/virtual-numbers/worldwide/status",
    {
      method: "POST",
      headers: {
        Accept: "application/json",
        "Content-Type": "application/json",
        Authorization: "Bearer ak_YOUR_API_KEY_HERE",
      },
      body: JSON.stringify({
        activation_id: "tigersms-17831000-123456",
        status: "2",
      }),
    }
  );
  const data = await response.json();
  ```
</CodeGroup>