> For the complete documentation index, see [llms.txt](https://docs.idlayr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.idlayr.com/changelog/readme/2025-11-14-coverage-by-phone-number.md).

# Phone Number Reachability with HLR (2025-11-14)

{% hint style="info" %}
**API** · 2025-11-14
{% endhint %}

Get the mobile network that a phone number belongs to along with products that are supported.

## What it is

A new backend-to-backend API that performs an HLR (Home Location Register) lookup for a given phone number to determine reachability and product coverage. Given a phone number, the API call returns information about the mobile carrier, country and which IDlayr atomic APIs (e.g., PhoneCheck, SIMCheck, etc) are supported for that number — enabling you to know in advance whether our network-based flows will work for that subscriber.

## Why it matters

* **Pre-flight coverage** — lets you decide whether to proceed with PhoneCheck / SIMCheck or return an `mno-not-supported` outcome earlier in the flow, avoiding unnecessary work.
* **Better routing and UX** — by identifying carrier / coverage up-front you can reduce failed attempts and choose the most appropriate authentication path.
* **Consistent naming** — this capability is exposed as Coverage by Phone Number (aka "Coverage / HLR" or "Reachability by Phone Number") across the product.

## Docs and endpoint

Full reference and request/response details are available in the docs:

<https://developer.idlayr.com/docs/reference/utils#tag/coverage/operation/get-coverage-by-phone-number>

{% hint style="warning" %}
This entry uses pre-v1 product names. In v1, **PhoneCheck** is renamed to [Secure SNA](https://docs.idlayr.com/products/number-verification/secure-sna), **SIMCheck** to [SIM Swap](https://docs.idlayr.com/products/risk/sim-swap), and the **Coverage / HLR / Reachability** capability is delivered as part of [Eligibility](https://docs.idlayr.com/products/eligibility).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.idlayr.com/changelog/readme/2025-11-14-coverage-by-phone-number.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.