# Location Results

A successful Phone Location Verification v1 request returns HTTP `200`.

| Field | Type | Description |
| --- | --- | --- |
| `code` | integer | HTTP-aligned result code. |
| `status` | string | `success`. |
| `client_transaction_id` | string | The submitted `transaction_id`. |
| `data` | object | Location result for the number. |
| `balance` | integer | Remaining balance or postpaid usage representation. |
| `transaction_id` | string | Privy's transaction identifier. |
| `message` | string | `phone location verification successful`. |

## Data object

| Field | Type | Description |
| --- | --- | --- |
| `phone` | string | Normalized mobile number. |
| `operator` | string | Detected mobile operator. |
| `score` | string | Provider-specific location score. |
| `msight_status` | string | Provider status when returned. |
| `result` | string | Location result when returned instead of a score. |

Score scales are operator-specific. Do not compare scores between API versions
or apply a pass threshold unless Privy has defined one for your integration.

```json
{
    "code": 200,
    "status": "success",
    "client_transaction_id": "location-v1-001",
    "data": {
        "phone": "628111234567",
        "operator": "Telkomsel",
        "score": "85"
    },
    "balance": 100,
    "transaction_id": "019c1234-5678-7abc-8def-0123456789ab",
    "message": "phone location verification successful"
}
```

