# Request Fields

Send an `application/json` body to `POST /api/v1/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 a Telkomsel number. |
| `location_type` | string | Yes | `home` or `work`. |
| `check_type` | string | Yes | address, coordinates, or zipcode. |
| `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. |
| `zip_code` | string | When `check_type` is `zipcode` | Exactly five digits. |
| `channel` | string | Yes | 1–100 alphanumeric or hyphen characters. |

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

```json
{
    "transaction_id": "location-v1-001",
    "msisdn": "628111234567",
    "location_type": "home",
    "check_type": "zipcode",
    "zip_code": "12190",
    "channel": "web"
}
```