Skip to main content

Phone Number Verification / HLR Data

Simple Query

Allows you to check the status of a phone number.

Endpoint  https://sms.witi.me/izdata/hlr.aspx?chave=API_KEY&telefone=phone
Method    GET
Input   "phone" filled with the phone number

Example call:

https://sms.witi.me/izdata/hlr.aspx?chave=API_KEY&telefone=11987654321

Batch Query

Allows you to check the status of multiple phone numbers simultaneously.

Endpoint  https://sms.witi.me/izdata/hlr.aspx?chave=API_KEY
Method    POST
Input   JSON list with the phone numbers

Example input:

["54992389592","11987654321"]

Output

The response will be a JSON with the following characteristics.

Class Root

PropertyContent
TelefonesList of returned phone numbers
ResultadoInformation about the query and billing

Class Telefone

PropertyContent
ValidoIndicates whether the phone number is valid or not
TelefonePhone number
CodOperadoraOperator code
TipoLine type code
0 Undefined
1 Landline
2 Others
3 Mobile
Country_codeCountry code
OperadoraName of the phone operator
DataConsultaDate the query was performed
WhatsAppIndicates if WhatsApp usage was registered for this line
WhatsAppDataStatusDate when this phone was registered using WhatsApp
TipoLinhaMobile or Landline

Example output:

{
{
"Telefones": [
{
"Valido": true,
"Telefone": "11987654321",
"CodOperadora": 55321,
"Tipo": 3,
"Country_code": "+55",
"Location": null,
"Operadora": "Claro - Celular",
"DataConsulta": "2021-10-18T00:00:00",
"WhatsApp": false,
"WhatsAppDataStatus": "0001-01-01T00:00:00",
"tipoHLR": 0,
"TipoLinha": "CELULAR",
}
],
"Resultado": {
"CodigoResultado": 0,
"Mensagem": "CONSULTA REALIZADA COM SUCESSO",
"Chave": "840b7921-c823-455e-cedc-5108b126b7ea",
"Cobrado": true,
"ValorCobrado": 0.0100
}
}