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

# Get Bulk HLR Lookups history

`GET /v1/bulk-lookups`

## Request

- Base URL: `https://api.dexatel.com`
- URL: `https://api.dexatel.com/v1/bulk-lookups`
- Auth: API key in header `X-Dexatel-Key`

## Query parameters

- `filter[name]` string: Filter(Starts With) single look ups by phone number as digits without spaces or special characters, beginning with the country dialing code
- `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
- `fileIndexSortKey` string: Sort key by file name returned in pagination property
- `id` string: Pagination identifier returned in pagination property

## Response `200`

OK

- BulkHLRLookupsResponseListWrapperDto
  - `data` BulkHLRLookupsResponseDto[]
    - `id` string, uuid: Unique identifier of the resource
    - `file_name` string: Uploaded file name
    - `account_id` string, uuid: Unique identifier of the account
    - `status` 'IN_PROGRESS' | 'FAILED' | 'COMPLETED' | 'NOT_ENOUGH_BALANCE': Indicates the progress of bulk lookup.
    - `total` number: Shows total count of numbers in the file
    - `checked` number: Shows count of checked numbers in the file
    - `skipped` number: Shows count of skipped numbers in the file
    - `create_date` string, date-time: Creation date of the bulk lookup in UTC, formatted as yyyy-mm-dd hh:mm:ss
  - `pagination` PaginationHLRBulk
    - `accountId` string, uuid: Unique identifier of the account
    - `id` string, uuid: Pagination identifier returned in pagination property
    - `accountIndexSortKey` string: Sort key by account identifier
    - `fileIndexSortKey` string: Sort key by file name identifier

---

[API](https://skmtc.dev/dexatel/apis/miscellaneous.md) - [All operations](https://skmtc.dev/dexatel/apis/miscellaneous/llms.txt) - [OpenAPI document](https://skmtc.dev/dexatel/apis/miscellaneous/revisions/44500422bb80?raw)