# Request Fields

Send an `application/json` body to `POST /api/v2/phone/location`.

| Field | Type | Required | Validation |
| --- | --- | --- | --- |
| `transaction_id` | string | Yes | 1–36 alphanumeric or hyphen characters; unique for the merchant request. |
| `msisdn` | string | Yes | 7–15 digits in normalized international format; must be an Indosat Ooredoo Hutchison number. |
| `location_type` | string | Yes | `home` or `work`. |
| `check_type` | string | Yes | address or coordinates. |
| `address` | string | When `check_type` is `address` | 1–255 characters. |
| `lat` | string | When `check_type` is `coordinates` | Valid latitude, 3–15 characters. |
| `long` | string | When `check_type` is `coordinates` | Valid longitude, 3–15 characters. |
| `channel` | string | Yes | 1–100 alphanumeric or hyphen characters. |

Only send the location field required by the selected `check_type`.

```json
{
    "transaction_id": "location-v2-001",
    "msisdn": "628551234567",
    "location_type": "home",
    "check_type": "coordinates",
    "lat": "-6.200000",
    "long": "106.816666",
    "channel": "web"
}
```