{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"pathItems":{},"requestBodies":{},"responses":{},"schemas":{},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"","title":"HLR Lookup","version":"1","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-catalogs":{"hlrlookup":{"description":"","title":"HLR Lookup","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-document":{"facts_hash":"a56df9549858ed5ffbc3be6ab1980f8b2ba709f97d9d81a8a707fd4d97a1341a","generator_version":"3","protocol_version":"1","schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"}}},"x-aisa-configured-paths":["/apis/v1/hlrlookup/people-phone-network","/apis/v1/hlrlookup/people-phone-verify"],"x-aisa-document":{"composer_version":"28","document_hash":"sha256:be6bae4a783a80104784fb248bf947628a7484b7e93ccd8ceefb37d3331fbdb1","facts_hash":"a56df9549858ed5ffbc3be6ab1980f8b2ba709f97d9d81a8a707fd4d97a1341a","generator_version":"3","protocol_version":"1","response_pending":[],"schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"},"x-aisa-provider":"hlrlookup"},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","openapi":"3.1.0","paths":{"/apis/v1/hlrlookup/people-phone-network":{"post":{"description":"Answers arrive in results[0]: current_network_details and is_ported. live_status is NOT_AVAILABLE_NETWORK_ONLY because this route does not check the line; use hlrlookup.people.phone.verify for that. For +1 numbers telephone_number_type is omitted. NO_COVERAGE, BAD_FORMAT and per-result errors are free.\n\n<!-- aisa-pricing:start -->\nUsage-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.\n<!-- aisa-pricing:end -->","operationId":"hlrlookup.people-phone-network","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"cache_days_global":{"description":"0 never reads the shared cache, so the lookup is live.","enum":[0],"maximum":0,"minimum":0,"type":"integer"},"cache_days_private":{"description":"0 never reads this account's cache, so the lookup is live.","enum":[0],"maximum":0,"minimum":0,"type":"integer"},"input_format":{"description":"ISO3 country code when telephone_number is in national format, e.g. GBR.","enum":["GBR"],"minLength":1,"type":"string"},"output_format":{"description":"Format of formatted_telephone_number: E164, PLUS_E164, NATIONAL, or an ISO3 country code.","type":"string"},"save_to_cache":{"description":"The result is cached only for this account, never shared.","enum":["PRIVATE"],"minLength":1,"type":"string"},"telephone_number":{"description":"International E.164 digits without the leading +, or a national number with input_format.","maxLength":32,"minLength":1,"type":"string"}},"required":["cache_days_global","cache_days_private","input_format","save_to_cache","telephone_number"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful response. The payload schema has not been reviewed yet."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Find which network serves a phone number","tags":["HLR Lookup"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"hlrlookup","x-aisa-category":"people","x-aisa-docs-url":"https://aisa.one/docs/api-reference/hlrlookup/hlrlookup-people-phone-network","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.003304,"estimate_source":"profile_seed","evidence_source":"response_header","unit":"provider_credit","unit_rate_usd":1e-06},"x-aisa-query-policy":{"ignore_undeclared":false,"open_query":true,"request_wins":false},"x-aisa-review":{"request":"reviewed_source","response":"generic","status":"unreviewed"},"x-aisa-revision":{"customer_pricing_ref":"fda7874df42d","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"bceb2f5231c6"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"hlrlookup.people-phone-network","path":"/apis/v1/hlrlookup/people-phone-network"},"x-aisa-source":{"content_hash":"sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566","converter":"scripts/prepare_treg_public_reference.py@1","fetched_at":"2026-11-07T11:52:30.302332+00:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978","qualification":"Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.","raw_content_hash":"sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68","refresh_policy":"pinned","refresh_reason":"Review immutable provider declarations and both gateway HTTP boundaries together.","review_period_days":30,"source_git_revision":"95670bbae5561fce0ea55c1e0ee4216eb34cbf18","source_pages":[{"scope":"pathParams arrive as query; array enum and numeric bounds semantics","url":"https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py"},{"scope":"Parameter declaration vocabulary and optional required flag","url":"https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py"}],"url":"https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/"},"x-aisa-status":"enabled","x-aisa-validation":"mixed"}},"/apis/v1/hlrlookup/people-phone-verify":{"post":{"description":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.013216 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"hlrlookup.people-phone-verify","requestBody":{"content":{"application/json":{"examples":{"default":{"value":{"cache_days_global":0,"cache_days_private":0,"input_format":"GBR","save_to_cache":"PRIVATE","telephone_number":"example","usa_status":"NO"}},"minimal":{"value":{"cache_days_global":0,"cache_days_private":0,"input_format":"GBR","save_to_cache":"PRIVATE","telephone_number":"example","usa_status":"NO"}}},"schema":{"additionalProperties":true,"properties":{"cache_days_global":{"enum":[0],"maximum":0,"minimum":0,"type":"integer"},"cache_days_private":{"enum":[0],"maximum":0,"minimum":0,"type":"integer"},"input_format":{"enum":["GBR"],"minLength":1,"type":"string"},"save_to_cache":{"enum":["PRIVATE"],"minLength":1,"type":"string"},"telephone_number":{"maxLength":32,"minLength":1,"type":"string"},"usa_status":{"enum":["NO"],"minLength":1,"type":"string"}},"required":["cache_days_global","cache_days_private","input_format","save_to_cache","telephone_number","usa_status"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful response. The payload schema has not been reviewed yet."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Check if a phone number is live","tags":["HLR Lookup"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"hlrlookup","x-aisa-category":"people","x-aisa-docs-url":"https://aisa.one/docs/api-reference/hlrlookup/hlrlookup-people-phone-verify","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.013216,"estimate_source":"profile_seed","evidence_source":"response_header","unit":"provider_credit","unit_rate_usd":1e-06},"x-aisa-query-policy":{"ignore_undeclared":false,"open_query":true,"request_wins":false},"x-aisa-review":{"request":"runtime_binding","response":"generic","status":"unreviewed"},"x-aisa-revision":{"customer_pricing_ref":"fda7874df42d","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"a7b5bd4110a8"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"hlrlookup.people-phone-verify","path":"/apis/v1/hlrlookup/people-phone-verify"},"x-aisa-status":"enabled","x-aisa-validation":"mixed","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/hlrlookup/people-phone-verify \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"cache_days_global\": 0,\n  \"cache_days_private\": 0,\n  \"input_format\": \"GBR\",\n  \"save_to_cache\": \"PRIVATE\",\n  \"telephone_number\": \"example\",\n  \"usa_status\": \"NO\"\n}'"}]}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}]}