{"uid":"cap_5uAaBzYmiISFBWkKu0WnY","slug":"numberintel-carrier-lookup-b525694d","name":"NumberIntel Carrier Lookup","description":"US phone carrier lookup: carrier of record, line type (mobile / landline / VoIP / pager), whether the number can be in service at all, rate center and risk hints for any US or US-territory number. NANPA public numbering data refreshed weekly; block-level, so ported numbers keep their original carrier.","url":"https://numberintel.dev/v1/carrier?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["number"],"properties":{"number":{"type":"string","description":"Phone number, any common format (E.164 preferred)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_B4xu1Zh5S75nzp7bG_G0B","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns carrier of record, line type (mobile/landline/VoIP/pager), in-service possibility, rate center, and risk hints for any US or US-territory phone number using NANPA block-level data.","exampleAgentPrompt":"Can you look up what carrier and line type is associated with the phone number +14155551234 — I want to know if it's a mobile, landline, or VoIP number and whether it can actually be in service?","exampleUseCases":[{"title":"SMS campaign pre-scrub","prompt":"Before I send out this SMS blast, check if +18005550199 is actually a mobile number or if it's a landline or VoIP — I only want to message real mobile lines."},{"title":"Fraud signal on new signup","prompt":"A user just signed up with phone number +13105550187 — can you check if it's a VoIP number and flag any risk hints? I want to catch fake registrations."},{"title":"Support ticket caller ID enrichment","prompt":"I have a support ticket from a customer who called from +12125550143 — what carrier is that number on, what type of line is it, and is it a real in-service number?"}],"resultDescription":"Returns the carrier of record (the original block owner, not necessarily the current carrier for ported numbers), line type classification (mobile, landline, VoIP, or pager), a flag indicating whether the number is plausibly in service, the NANPA rate center, and risk hints — all derived from weekly-refreshed NANPA block-level data.","failureModes":["Non-US or non-NANPA number submitted — endpoint only covers US and US-territory numbers","Invalid or unparseable phone number format — returns error if number cannot be normalized","Number in an unallocated or unassigned NANPA block — in-service flag will indicate cannot be in service","Rate limiting or payment failure — 402 response if USDC payment not properly attached","Ported numbers return original block-level carrier, not current carrier — may not reflect post-port carrier"],"whenToPreferThis":"Choose this endpoint when you need block-level NANPA carrier and line type data for US numbers and do not require real-time HLR/MNP porting data. It is ideal for pre-campaign scrubbing, fraud screening at signup, and enriching contact records where the original carrier assignment is sufficient. Prefer this over bulk endpoints when checking individual numbers on demand. Use the bulk sibling endpoint if you need to scrub large lists efficiently.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T18:42:01.850Z","isFirstParty":false,"canonicalSlug":"numberintel-carrier-lookup-b525694d"}