---
title: "Create Single HLR Lookup"
method: GET
path: "/v1/number-lookups/{number}"
tags: ["HLR Lookup"]
---

# Create Single HLR Lookup

`GET /v1/number-lookups/{number}`

## Response `200`

OK

- HLRLookupsResponseWrapperDto
  - `data` HLRLookupsResponseDto
    - `id` string, uuid — Unique identifier of the resource
    - `account_id` string, uuid — Unique identifier of the account
    - `msisdn` string — Phone number as digits without spaces or special characters, beginning with the country dialing code
    - `status` 'valid' | 'inactive' | 'unavailable_network' | 'invalid_number' | 'hlr_error' — Current status of phone number. 'valid' - The provided number is valid and can be reached. 'inactive' - The provided number is not reachable. 'unavailable_network' - Information on the provided number is not available. 'invalid_number' - The provided number is in an invalid format. 'hlr_error' - An error occurred during the HLR lookup.
    - `ported` boolean — Identifies if number is permanently moved to another provider
    - `line` 'landline' | 'mobile' | 'service' — Phone number line type. Possible values: 'landline', 'mobile', 'service' (Number is classified as a special service number rather than a regular mobile or landline number).
    - `network` string — Phone number network.
    - `mccmnc` string — The mobile country code consists of three decimal digits and the mobile network code consists of two or three decimal digits
    - `country` string — Represents the country ISO code associated with the phone number
    - `country_name` string — Represents the country name associated with the phone number
    - `client_rate` number — Lookup cost including tax.
    - `payment_status` string — Represents the payment status of HLR Lookup.
    - `reported_date` string, date-time — Creation date of the HLR Lookup in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `error` string, string — Code identifying the specific error. <br /> <table> <tbody> <tr> <th>Code</th> <th>Description</th> </tr> <tr> <td>0001</td> <td>The subscriber is unknown; this number is not allocated</td> </tr> <tr> <td>0004</td> <td>The provided number is switched off</td> </tr> <tr> <td>0006</td> <td>The provided number is in an invalid format</td> </tr> <tr> <td>0009</td> <td>The number exists, but authenticate in not available</td> </tr> <tr> <td>0011</td> <td>The phone number is not allowed to receive SMS</td> </tr> <tr> <td>0012</td> <td>The number is restricted</td> </tr> <tr> <td>0014</td> <td>End device doesn’t have SMS capability</td> </tr> <tr> <td>0020</td> <td>Request timeout</td> </tr> <tr> <td>0021</td> <td>System failure</td> </tr> <tr> <td>0101</td> <td>Information on the provided number is not available</td> </tr> <tr> <td>0102</td> <td>Information on the provided number is not available</td> </tr> <tr> <td>0103</td> <td>Landline</td> </tr> <tr> <td>0050</td> <td>Internal error</td> </tr><tr> <td>0051</td> <td>Your balance was not enough.</td> </tr> </tbody> </table>

## Other responses

- `400` — **Bad Request:** Code Message Description 7906 Trial account limit reached 7910 Invalid phone number Phone number should contain digits without spaces or special characters, beginning with the country dialing code 7916 This direction is not supported at this moment Pricing rate not found

---

[API](https://skmtc.net/dexatel/apis/verify-apis.md) · [All operations](https://skmtc.net/dexatel/apis/verify-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dexatel/verify-apis/revisions/a924257f431d/schema)