Skip to main content
POST
Find which network serves a phone number

Request contract

  • Method and path: POST /apis/v1/hlrlookup/people-phone-network
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/hlrlookup/people-phone-network
  • Runtime facts: a56df9549858ed5ffbc3be6ab1980f8b2ba709f97d9d81a8a707fd4d97a1341a
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.003304 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.003304
  • Declared unit rate (USD): 1e-06
  • Billing unit: provider_credit
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Settlement evidence source: response_header

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
telephone_number
string
required

International E.164 digits without the leading +, or a national number with input_format.

Required string length: 1 - 32
input_format
enum<string>
required

ISO3 country code when telephone_number is in national format, e.g. GBR.

Available options:
GBR
Minimum string length: 1
save_to_cache
enum<string>
required

The result is cached only for this account, never shared.

Available options:
PRIVATE
Minimum string length: 1
cache_days_global
enum<integer>
required

0 never reads the shared cache, so the lookup is live.

Available options:
0
Required range: 0 <= x <= 0
cache_days_private
enum<integer>
required

0 never reads this account's cache, so the lookup is live.

Available options:
0
Required range: 0 <= x <= 0
output_format
string

Format of formatted_telephone_number: E164, PLUS_E164, NATIONAL, or an ISO3 country code.

Response

Successful response