DISPONÍVEL

Validação de telefones, no formato E.164.

Os telefones chegam em todas as formas — "+54 (11) 4555-2233", "011 …", "15 …". A Normadata faz parse do número, normaliza para E.164 com o país como região de parsing e classifica a linha (mobile, landline, mobile_or_landline, other) — um lote de até 1.000 por request.

E.164
saída
Global
parsing de telefone
1.000
telefones por request
0
lookups gov
01 · PROBLEMA

Um telefone cru não é um telefone armazenável

Os telefones chegam em todas as formas — "+54 9 11 …", "011 …", "15 …" — e reconhecer um móvel, um fixo ou um número inválido não é trivial. Sem normalizar para E.164, sua base guarda variantes do mesmo número e suas integrações de SMS/voz batem. A Normadata faz parse, normaliza para E.164 e classifica o tipo de linha — em lote.

02 · CAPACIDADES

Parsing E.164 e classificação de linha

Cada telefone do lote, normalizado e explicado.

01

Normalização · E.164

Faz parse do número e devolve a forma E.164 canônica. O país (campo country) é a região de parsing quando não há prefixo.

value + country → normalized
02

Tipo de linha

Classifica a linha: mobile, landline, mobile_or_landline ou other.

value → type
03

Validade

Devolve valid segundo o plano de numeração do país. Um número com comprimento ou prefixo inválido volta com error.

value → valid
04

Lote

Mande até 1.000 telefones por request. Cada um volta correlacionado pelo id que você fornece.

items[] → results[]
03 · COBERTURA

Parsing global por região

O parsing cobre os planos de numeração internacionais; o país que você passa por item fixa a região quando o número não traz prefixo.

🇦🇷AR
Argentina
CUITCUILDNICBUCVU
🇧🇷BR
Brasil
CPFCNPJ
04 · USO

Um lote de telefones, um resultado por item

Mande um array items com id, value e country por telefone. Receba valid, normalized (E.164) e type. O mesmo endpoint valida 1 ou N.

POST /v1/validate/phones
$ curl -X POST https://api.normadata.io/v1/validate/phones \
    -H "X-API-Key: nd_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5" \
    -H "Content-Type: application/json" \
    -d '{"items":[
      {"id":"1","value":"+54 (11) 4555-2233","country":"AR"},
      {"id":"2","value":"11987654321","country":"BR"}
    ]}'
Resposta
{
  "results": [
    {
      "id":         "1",
      "valid": true,
      "normalized": "+541145552233",
      "type":       "landline"
    },
    {
      "id":         "2",
      "valid": true,
      "normalized": "+5511987654321",
      "type":       "mobile"
    }
  ]
}

Telefones em E.164, validados em lote

Grátis durante o acesso antecipado. Mande um email e respondemos em 24 horas.