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

# Lookup Uganda Telco Subscriber

> Retrieve registered name and phone number for a Ugandan mobile subscriber from the telco database. Used for identity and KYC checks.

### Request

```http [POST] theme={null}
{{baseUrl}}/api/v1/ug/kyc/telco
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                  |

### Query parameter

| Parameter        | Type   | Description                         | Required |
| ---------------- | ------ | ----------------------------------- | -------- |
| last\_name \*    | string | Last name of the subscriber         | required |
| first\_name \*   | string | First name of the subscriber.       | required |
| phone\_number \* | string | The phone number of the subscriber. | required |

### Sample response

```json Response theme={null}

{
  "entity": {
    "first_name": "John",
    "last_name": "Musa",
    "name_check_error": null,
    "network_name": "",
    "percentage_name_match": 100,
    "phone_is_mm_registered": false,
    "phone_number": "+25612345678",
    "verified_name": "John Doe Musa"
  }
}

```

### Response Fields

| Field                            | Type        | Description                                                    |
| -------------------------------- | ----------- | -------------------------------------------------------------- |
| entity                           | object      | Contains the verification response data                        |
| entity.first\_name               | string      | First name of the subscriber                                   |
| entity.last\_name                | string      | Last name of the subscriber                                    |
| entity.name\_check\_error        | string/null | Error message from name check, or null if no error             |
| entity.network\_name             | string      | Name of the mobile network operator                            |
| entity.percentage\_name\_match   | number      | Percentage match between provided and registered names (0-100) |
| entity.phone\_is\_mm\_registered | boolean     | Whether the phone number is registered for mobile money        |
| entity.phone\_number             | string      | Phone number of the subscriber                                 |
| entity.verified\_name            | string      | Full verified name from the telco records                      |