AgiNúmeros - Consulta de Operadora e Área Local

Serviço de alta performance para identificação de operadoras ativas (fixas e móveis), verificação de portabilidade numérica em tempo real e consulta de área local geográfica no Brasil.

URL Base do Serviço

https://agilink.agitel.dev/v1/aginumeros

Endpoints & Métodos

4 endpoint(s)

GET

/operadora

Custo: 1 crédito(s)

Consultar Operadora (Individual via GET)

Consulta em tempo real a operadora ativa e status de portabilidade para um único número nacional. Informe o número com código DDD no parâmetro da URL.

Parâmetros

Nome	Descrição
numero	Número de telefone nacional com DDD (ex: 84991975458 ou 11987654321)

Exemplo de Resposta (200 OK)

{
    "operadora": "CLARO",
    "portado": true
}

Exemplo de Execução cURL

curl -X GET "https://agilink.agitel.dev/v1/aginumeros/operadora" \
  -H "Authorization: Bearer <SEU_TOKEN>" \
  -H "Accept: application/json"

POST

/operadora

Custo: 1 crédito(s)

Consultar Operadora (Individual ou em Lote via POST)

Permite consultar a operadora de um único número ou múltiplos números em lote através de um payload JSON. Quando múltiplos números forem enviados, a resposta conterá um array com os resultados.

Exemplo de Payload (Request Body JSON)

{
    "numeros": [
        "84991975458",
        "11987654321"
    ]
}

Exemplo de Resposta (200 OK)

[
    {
        "numero": "84991975458",
        "operadora": "CLARO",
        "portado": true
    },
    {
        "numero": "11987654321",
        "operadora": "VIVO",
        "portado": false
    }
]

Exemplo de Execução cURL

curl -X POST "https://agilink.agitel.dev/v1/aginumeros/operadora" \
  -H "Authorization: Bearer <SEU_TOKEN>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"numeros":["84991975458","11987654321"]}'

GET

/area-local

Custo: 1 crédito(s)

Consultar Área Local (GET)

Identifica a área local de tarifação, o tipo de linha (Móvel ou Fixo), o estado (UF) e o DDD correspondente ao número ou prefixo.

Parâmetros

Nome	Descrição
numero	Número de telefone ou prefixo telefônico com DDD (ex: 84991975458 ou 1130001000)

Exemplo de Resposta (200 OK)

{
    "tipo": "fixo",
    "uf": "PE",
    "ddd": "81",
    "area_local_id": 812
}

Exemplo de Execução cURL

curl -X GET "https://agilink.agitel.dev/v1/aginumeros/area-local" \
  -H "Authorization: Bearer <SEU_TOKEN>" \
  -H "Accept: application/json"

POST

/area-local

Custo: 1 crédito(s)

Consultar Área Local (POST)

Envia o número telefônico via payload JSON para identificar sua área local, estado e tipo de telefonia.

Exemplo de Payload (Request Body JSON)

{
    "numero": "8132210000"
}

Exemplo de Resposta (200 OK)

{
    "tipo": "fixo",
    "uf": "PE",
    "ddd": "81",
    "area_local_id": 812
}

Exemplo de Execução cURL

curl -X POST "https://agilink.agitel.dev/v1/aginumeros/area-local" \
  -H "Authorization: Bearer <SEU_TOKEN>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"numero":"8132210000"}'