{
"input": "+14155552671",
"valid": true,
"possible": true,
"country": "US",
"countryCallingCode": "+1",
"nationalNumber": "4155552671",
"e164": "+14155552671",
"internationalFormat": "+1 415 555 2671",
"nationalFormat": "(415) 555-2671",
"type": "FIXED_LINE_OR_MOBILE",
"uri": "tel:+14155552671",
"note": "Type is inferred from numbering plans (MOBILE / FIXED_LINE / TOLL_FREE / etc.). Carrier lookup is not included."
}
curl --location --request GET 'https://zylalabs.com/api/14774/phonecheck+api/38274/validate+phone?phone=+14155552671&country=US' --header 'Authorization: Bearer YOUR_API_KEY'
{
"input": "+14155552671",
"valid": true,
"possible": true,
"country": "US",
"countryCallingCode": "+1",
"nationalNumber": "4155552671",
"e164": "+14155552671",
"internationalFormat": "+1 415 555 2671",
"nationalFormat": "(415) 555-2671",
"type": "FIXED_LINE_OR_MOBILE",
"uri": "tel:+14155552671",
"note": "Type is inferred from numbering plans (MOBILE / FIXED_LINE / TOLL_FREE / etc.). Carrier lookup is not included."
}
curl --location --request POST 'https://zylalabs.com/api/14774/phonecheck+api/38275/validate+phone+via+post' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"phone": "+14155552671", "country": "US"}'
{
"total": 2,
"results": [
{
"input": "+14155552671",
"valid": true,
"possible": true,
"country": "US",
"countryCallingCode": "+1",
"nationalNumber": "4155552671",
"e164": "+14155552671",
"internationalFormat": "+1 415 555 2671",
"nationalFormat": "(415) 555-2671",
"type": "FIXED_LINE_OR_MOBILE",
"uri": "tel:+14155552671",
"note": "Type is inferred from numbering plans (MOBILE / FIXED_LINE / TOLL_FREE / etc.). Carrier lookup is not included."
},
{
"input": "+442071234567",
"valid": true,
"possible": true,
"country": "GB",
"countryCallingCode": "+44",
"nationalNumber": "2071234567",
"e164": "+442071234567",
"internationalFormat": "+44 20 7123 4567",
"nationalFormat": "020 7123 4567",
"type": "FIXED_LINE",
"uri": "tel:+442071234567",
"note": "Type is inferred from numbering plans (MOBILE / FIXED_LINE / TOLL_FREE / etc.). Carrier lookup is not included."
}
],
"summary": {
"total": 2,
"valid_count": 2,
"invalid_count": 0,
"valid_rate": 1,
"invalid_numbers": [],
"by_country": {
"US": 1,
"GB": 1
},
"by_type": {
"FIXED_LINE_OR_MOBILE": 1,
"FIXED_LINE": 1
},
"duplicates": [],
"duplicate_count": 0
}
}
curl --location --request POST 'https://zylalabs.com/api/14774/phonecheck+api/38276/validate+phone+batch' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"numbers": ["+14155552671", "+442071234567"]}'
{
"count": 245,
"countries": [
{
"country": "AC",
"callingCode": "+247"
},
{
"country": "AD",
"callingCode": "+376"
},
{
"country": "AE",
"callingCode": "+971"
},
{
"country": "AF",
"callingCode": "+93"
},
{
"country": "AG",
"callingCode": "+1"
},
{
"country": "AI",
"callingCode": "+1"
},
{
"country": "AL",
"callingCode": "+355"
},
{
"country": "AM",
"callingCode": "+374"
},
{
"country": "AO",
"callingCode": "+244"
},
{
"country": "AR",
"callingCode": "+54"
},
{
"country": "AS",
"callingCode": "+1"
},
{
"country": "AT",
"callingCode": "+43"
},
{
"country": "AU",
"callingCode": "+61"
},
{
"country": "AW",
"callingCode": "+297"
},
{
"country": "AX",
"callingCode": "+358"
},
{
"country": "AZ",
"callingCode": "+994"
},
{
"country": "BA",
"callingCode": "+387"
},
{
"country": "BB",
"callingCode": "+1"
},
{
"country": "BD",
"callingCode": "+880"
},
{
"country": "BE",
"callingCode": "+32"
},
{
"country": "BF",
"callingCode": "+226"
},
{
"country": "BG",
"callingCode": "+359"
},
{
"country": "BH",
"callingCode": "+973"
},
{
"country": "BI",
"callingCode": "+257"
},
{
"country": "BJ",
"callingCode": "+229"
},
{
"country": "BL",
"callingCode": "+590"
},
{
"country": "BM",
"callingCode": "+1"
},
{
"country": "BN",
"callingCode": "+673"
},
{
"country": "BO",
"callingCode": "+591"
},
{
"country": "BQ",
"callingCode": "+599"
},
{
"country": "BR",
"callingCode": "+55"
},
{
"country": "BS",
"callingCode": "+1"
},
{
"country": "BT",
"callingCode": "+975"
},
{
"country": "BW",
"callingCode": "+267"
},
{
"country": "BY",
"callingCode": "+375"
},
{
"country": "BZ",
"callingCode": "+501"
},
{
"country": "CA",
"callingCode": "+1"
},
{
"country": "CC",
"callingCode": "+61"
},
{
"country": "CD",
"callingCode": "+243"
},
{
"country": "CF",
"callingCode": "+236"
},
{
"country": "CG",
"callingCode": "+242"
},
{
"country": "CH",
"callingCode": "+41"
},
{
"country": "CI",
"callingCode": "+225"
},
{
"country": "CK",
"callingCode": "+682"
},
{
"country": "CL",
"callingCode": "+56"
},
{
"country": "CM",
"callingCode": "+237"
},
{
"country": "CN",
"callingCode": "+86"
},
{
"country": "CO",
"callingCode": "+57"
},
{
"country": "CR",
"callingCode": "+506"
},
{
"country": "CU",
"callingCode": "+53"
},
{
"country": "CV",
"callingCode": "+238"
},
{
"country": "CW",
"callingCode": "+599"
},
{
"country": "CX",
"callingCode": "+61"
},
{
"country": "CY",
"callingCode": "+357"
},
{
"country": "CZ",
"callingCode": "+420"
},
{
"country": "DE",
"callingCode": "+49"
},
{
"country": "DJ",
"callingCode": "+253"
},
{
"country": "DK",
"callingCode": "+45"
},
{
"country": "DM",
"callingCode": "+1"
},
{
"country": "DO",
"callingCode": "+1"
},
{
"country": "DZ",
"callingCode": "+213"
},
{
"country": "EC",
"callingCode": "+593"
},
{
"country": "EE",
"callingCode": "+372"
},
{
"country": "EG",
"callingCode": "+20"
},
{
"country": "EH",
"callingCode": "+212"
},
{
"country": "ER",
"callingCode": "+291"
},
{
"country": "ES",
"callingCode": "+34"
},
{
"country": "ET",
"callingCode": "+251"
},
{
"country": "FI",
"callingCode": "+358"
},
{
"country": "FJ",
"callingCode": "+679"
},
{
"country": "FK",
"callingCode": "+500"
},
{
"country": "FM",
"callingCode": "+691"
},
{
"country": "FO",
"callingCode": "+298"
},
{
"country": "FR",
"callingCode": "+33"
},
{
"country": "GA",
"callingCode": "+241"
},
{
"country": "GB",
"callingCode": "+44"
},
{
"country": "GD",
"callingCode": "+1"
},
{
"country": "GE",
"callingCode": "+995"
},
{
"country": "GF",
"callingCode": "+594"
},
{
"country": "GG",
"callingCode": "+44"
},
{
"country": "GH",
"callingCode": "+233"
},
{
"country": "GI",
"callingCode": "+350"
},
{
"country": "GL",
"callingCode": "+299"
},
{
"country": "GM",
"callingCode": "+220"
},
{
"country": "GN",
"callingCode": "+224"
},
{
"country": "GP",
"callingCode": "+590"
},
{
"country": "GQ",
"callingCode": "+240"
},
{
"country": "GR",
"callingCode": "+30"
},
{
"country": "GT",
"callingCode": "+502"
},
{
"country": "GU",
"callingCode": "+1"
},
{
"country": "GW",
"callingCode": "+245"
},
{
"country": "GY",
"callingCode": "+592"
},
{
"country": "HK",
"callingCode": "+852"
},
{
"country": "HN",
"callingCode": "+504"
},
{
"country": "HR",
"callingCode": "+385"
},
{
"country": "HT",
"callingCode": "+509"
},
{
"country": "HU",
"callingCode": "+36"
},
{
"country": "ID",
"callingCode": "+62"
},
{
"country": "IE",
"callingCode": "+353"
},
{
"country": "IL",
"callingCode": "+972"
},
{
"country": "IM",
"callingCode": "+44"
},
{
"country": "IN",
"callingCode": "+91"
},
{
"country": "IO",
"callingCode": "+246"
},
{
"country": "IQ",
"callingCode": "+964"
},
{
"country": "IR",
"callingCode": "+98"
},
{
"country": "IS",
"callingCode": "+354"
},
{
"country": "IT",
"callingCode": "+39"
},
{
"country": "JE",
"callingCode": "+44"
},
{
"country": "JM",
"callingCode": "+1"
},
{
"country": "JO",
"callingCode": "+962"
},
{
"country": "JP",
"callingCode": "+81"
},
{
"country": "KE",
"callingCode": "+254"
},
{
"country": "KG",
"callingCode": "+996"
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/14774/phonecheck+api/38277/list+countries' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a PhoneCheck API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
API de validação de números de telefone para mais de 240 países: validade do plano de numeração, país, formatos E.164 e de exibição, tipo de linha onde os dados do plano suportam isso. Lote de até 100
Até 100 e um lote conta como uma chamada de API Enviar mais de 100 retorna um erro 400 BATCH_TOO_LARGE nomeando o limite e quantos você enviou - divida a lista e tente novamente
Porque os metadados do plano de numeração para esse mercado não separam os tipos de linha Os números da China continental França Alemanha Brasil e Índia costumam retornar DESCONHECIDO; os números dos EUA GB e AU possuem dados de tipo confiáveis A validade o país e a formatação não são afetados
Não. Isso significa que o número está corretamente formado de acordo com o plano de numeração do seu país. O PhoneCheck apenas faz a análise do plano de numeração - sem verificação de operadora, sem verificação de alcançabilidade
245 países GET /countries lista todos os países suportados com seu código de discagem
Sim A análise é feita localmente com libphonenumber — os mesmos dados do plano de numeração por trás do Android — então um número retorna exatamente o mesmo veredicto do único ponto de extremidade e dentro de um lote