service_type carrier
Descubra a operadora à qual um número foi originalmente alocado, com tipo de linha e localização.
POST /api/v1/check
Consulta da operadora originalNão é necessário entrar.
Contrato da API
Envie um número e selecione este produto com service_type. A autenticação usa sua chave de API.
Copie o comando curl abaixo e substitua apenas a chave de API de exemplo pela sua.
POST /api/v1/checkcurl -X POST "https://carrierlookup.online/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "carrier", "identifier": "+17253100591" }'200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "carrier",
"identifier": "+17253100591",
"carrier": "T-Mobile",
"underlying_carrier": "",
"number_type": "Fixed Line or Mobile",
"country_code": "US",
"region": "NV",
"city": "LAS VEGAS"
}
}Como usar
Envie o número no formato E.164: um sinal de mais, o código do país e, em seguida, o número do assinante, sem espaços ou separadores — por exemplo +17253100591.
O painel SaaS e a API síncrona retornam a mesma estrutura de resposta, com a operadora original e os campos relacionados.
Uma resposta bem-sucedida retorna os campos da operadora de forma síncrona. Eles descrevem a alocação original, que a portabilidade não altera; por isso, repetir a consulta não revelará uma operadora posterior. Obtenha consentimento separadamente antes de contatar qualquer pessoa.
O que verifica
carrier · string — Operadora à qual o número foi originalmente alocado. Não é a operadora atual após a portabilidade.underlying_carrier · string — Operadora subjacente informada pelo provedor quando difere da alocada; string vazia quando o provedor não a fornece.number_type · string — Tipo de linha informado pelo provedor; vazio quando indisponível.country_code · string — Código ISO do país ao qual o número pertence.region · string — Região de alocação; vazia quando o provedor não a fornece.city · string — Cidade de alocação; vazia quando o provedor não a fornece.Ideal para
Leia a operadora à qual um número foi originalmente alocado e o tipo de linha antes de executar as regras internas de roteamento seguintes.
Registre a operadora original e a região de alocação em modelos de custo ou registros de compras para revisar os custos esperados das faixas de numeração.
Compare a alocação, o país e a região de um número com os registros de contato existentes para encontrar dados ausentes ou inconsistentes.
Agrupe listas de números por operadora original, tipo de linha e região de alocação para que o trabalho de dados posterior tenha dimensões claras.
Resposta direta
Consulta da operadora original retorna a operadora à qual o número foi originalmente alocado, seu tipo de linha e a região à qual pertence. Use service_type carrier (o parâmetro que seleciona um produto) com um número no formato E.164, por exemplo +17253100591, e leia os campos da operadora na mesma resposta da API.
Limites claros
Perguntas frequentes do produto
Ela verifica um número e retorna a operadora à qual o número foi originalmente alocado, seu tipo de linha e a região à qual pertence na mesma resposta síncrona.
O saldo é cobrado apenas por verificações concluídas. Verificações com falha ou indeterminadas não mantêm a cobrança.
Envie um número no formato E.164, por exemplo +17253100591. O código do país faz parte do número, então você não seleciona um país separadamente.
Não. Ele informa apenas a rede à qual um número foi originalmente alocado; não acompanha a portabilidade e não significa que o número esteja acessível. O consentimento e as regras aplicáveis continuam sendo sua responsabilidade.
Crie uma conta para usar todos os produtos pelo painel SaaS ou pela API: verificações em tempo real e verificações em massa assíncronas usam o mesmo saldo.