---
title: "List HLR lookup history"
method: GET
path: "/api/v2/hlr/history"
tags: ["HLR Lookups"]
---

# List HLR lookup history

`GET /api/v2/hlr/history`

## Request

- Base URL: `https://app.didlogic.com`
- URL: `https://app.didlogic.com/api/v2/hlr/history`
- Auth: HTTP bearer

Returns the caller's HLR lookup logs — one per number checked — with the lookup result
(validity, carrier, MCC/MNC, phone type, ported and risky flags, country). Supports
filtering by number prefix, status, and date ranges, plus pagination.

## Query parameters

- `ids` string
- `task_ids` string
- `number` string
- `number_start` integer
- `status` 'pending' | 'completed' | 'failed'
- `created_at_from` string, date
- `created_at_to` string, date
- `processed_at_from` string, date
- `processed_at_to` string, date
- `order_by` string
- `order` 'asc' | 'desc'
- `page` integer
- `per_page` integer

## Response `200`

returns the caller HLR logs filtered by number prefix

- object
  - `logs` object[], required: List of HLR lookup logs
    - `id` integer, required: Log identifier
    - `number` string, required: Phone number that was checked
    - `status` 'pending' | 'completed' | 'failed', required: Lookup status
    - `phone_type` string, required: Line type (e.g. mobile, fixed)
    - `carrier` string, required: Carrier / operator name
    - `mcc` string, required: Mobile Country Code
    - `mnc` string, required: Mobile Network Code
    - `ported` boolean, required: Whether the number was ported
    - `risky` boolean, required: Whether the destination is flagged risky
    - `country` string, required: Country
    - `task_id` integer, required: Parent task identifier
    - `processed_at` string, required: Processing completion timestamp
    - `created_at` string, required: Log creation timestamp
    - `valid` boolean, required: Whether the number is valid
    - `price` string, required: Client price charged for this lookup (USD)
    - `error_code` '000' | '113' | '121' | '199', nullable, required: Normalized lookup error code: 000 — OK, 113 — Internal service error, 121 — Invalid phone number length or format, 199 — Unexpected error. null when no result is available yet.
  - `pagination` object, required: Pagination metadata
    - `total` integer, required: Total number of items
    - `total_pages` integer, required: Total number of pages
    - `current_page` integer, required: Current page number
    - `per_page` integer, required: Items per page

## Other responses

- `401`: returns unauthorized
- `403`: returns forbidden

---

[API](https://skmtc.dev/didlogic/apis/get-started.md) · [All operations](https://skmtc.dev/didlogic/apis/get-started/llms.txt) · [OpenAPI document](https://skmtc.dev/didlogic/apis/get-started/revisions/dc972d592b34?raw)