HLR Lookups

List HLR lookup history

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.

get/api/v2/hlr/history

Request

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

Query parameters

idsstring

Filter logs by log IDs (comma-separated)

task_idsstring

Filter logs by task IDs (comma-separated), from hlr_create

numberstring

Filter logs by specific phone numbers (comma-separated)

number_startinteger

Filter logs by phone-number prefix (starts-with)

status'pending' | 'completed' | 'failed'

Filter by status

created_at_fromstring date

Filter created from this date (YYYY-MM-DD)

created_at_tostring date

Filter created until this date (YYYY-MM-DD)

processed_at_fromstring date

Filter processed from this date (YYYY-MM-DD)

processed_at_tostring date

Filter processed until this date (YYYY-MM-DD)

order_bystring

Field to sort by

order'asc' | 'desc'

Sort order

pageinteger

Page number for pagination (starts from 1)

per_pageinteger

Number of items per page

Response

returns the caller HLR logs filtered by number prefix

Example response

{
  "logs": [
    {
      "id": 23,
      "number": "12125551234",
      "status": "completed",
      "phone_type": "mobile",
      "carrier": "Acme Telecom",
      "mcc": "310",
      "mnc": "260",
      "country": "US",
      "task_id": 17,
      "processed_at": "2026-10-14T16:39:36Z",
      "created_at": "2026-10-14T16:39:36Z",
      "valid": true,
      "price": "0.07"
    }
  ],
  "pagination": {
    "total": 1,
    "total_pages": 1,
    "current_page": 1,
    "per_page": 10
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.