---
title: "Get Your HLR Lookups history"
method: GET
path: "/v1/number-lookups"
tags: ["HLR Lookup"]
---

# Get Your HLR Lookups history

`GET /v1/number-lookups`

## Query parameters

- `filter[number]` string — Filter(Starts With) bulk look ups by file name
- `limit` string — Limit of HLR Lookups to return per request
- `accountId` string, uuid — Unique identifier of the account
- `accountIndexSortKey` string — Sort key by account returned in pagination property
- `msisdnIndexSortKey` string — Sort key by msisdn returned in pagination property
- `id` string — Pagination identifier returned in pagination property

## Response `200`

OK

- HLRLookupsResponseListWrapperDto
  - `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>
  - `pagination` PaginationHLRSingle
    - `accountId` string, uuid — Unique identifier of the account
    - `id` string, uuid — Pagination identifier returned in pagination property
    - `accountIndexSortKey` string — Sort key by account identifier
    - `msisdnIndexSortKey` string — Sort key by msisdn identifier

---

[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)