Skip to main content

Create HLR lookup

POST 
/api/v2/hlr

Submits phone numbers for an HLR (Home Location Register) lookup (maximum 1500 numbers per request).

Numbers must be supplied in E.164 format (e.g. +14155552671); a leading + is added automatically when omitted.

A single number resolves synchronously; larger batches are processed asynchronously — poll the history endpoint (GET /api/v2/hlr/history) for results. Lookups are performed independently of call setup and do not affect PDD. Results are not cached: each request re-queries the provider.

Authentication:

  • Requires Bearer token in Authorization header: Authorization: Bearer <token>

Request​

Responses​

returns the created HLR lookup task