> For the complete documentation index, see [llms.txt](https://docs.pretium.africa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pretium.africa/utilities/verification/phone-number-verification.md).

# Phone Number Verification

This endpoint validates a phone number and returns the registered individual's name as provided by Mobile Network Operators (MNOs).

Note: Reliability varies by country, so avoid heavy dependence on this endpoint for phone number validation.

```
POST {{url}}/v1/validation/{currency_code}
```

```
{
    "type": "MOBILE",
    "shortcode": "0700123456",
    "mobile_network": "Safaricom"
}
```

{% tabs %}
{% tab title="Request Body" %}

```
{
    "shortcode": "0700123456",
     "type": "MOBILE",
     "network": "Safaricom"
}
  

```

{% endtab %}

{% tab title="200 - Success" %}

```
{
    "code": 200,
    "message": "Validation results",
    "data": {
        "status": "COMPLETE",
        "shortcode": "0700123456",
        "public_name": "JOHN DOE"
    }
}

```

{% endtab %}

{% tab title="400 - Bad Request" %}

```
{
   "code": 400,
   "message": "Failed - Bad Request"
}
```

{% endtab %}
{% endtabs %}