A API Number Recycling permite que empresas verifiquem se um número de telefone teve a titularidade alterada desde uma determinada data. Isso é essencial para aplicações sensíveis à segurança, como autenticação e comunicação com o cliente, onde é fundamental garantir que o número ainda pertence ao usuário. A solução pode ser combinada com a API Tenure para uma visão completa do período de atividade de uma linha com o titular atual.
A nossa API é “restful”, ou seja, o nosso protocolo de comunicação foi criado de uma forma que pode interpretar qualquer linguagem de programação. Isso torna o processo de integração do lado dos nossos clientes e parceiros mais flexível e de fácil entendimento. Na página de documentação deixamos alguns exemplos de linguagem, caso seja necessário.
Os retornos fornecidos, quando vinculados a outras medidas, podem se tornar meios eficazes de evitar que sejam praticadas fraudes, minimizando assim, o seu impacto no ambiente de negócios.
• Validação em tempo real dos dados fornecidos.
• Acesso a informações verificadas pela Operadora.
• Garantia de precisão e segurança nos processos de verificação.
• Total conformidade com as regulamentações de privacidade.
Melhore a qualidade dos dados, reduza fraudes e ofereça uma experiência mais confiável para seus usuários com a nossa solução robusta e eficiente. Integre facilmente e eleve o nível de confiabilidade do seu serviço!
Versão: 0.2.1
Criada por: Claro | GSMA Opengateway
Data: 02/12/2025
Passo a passo
Caso ainda tenha duvidas, baixe o PDF abaixo com o tutorial de integração da API Number Recycling. Ele te explica passo a passo como utilizá-la.
200 -A solicitação foi bem-sucedida. A resposta contém o resultado da validação dos dados do cliente.
400 - A solicitação não pôde ser entendida pelo servidor devido à sintaxe incorreta ou parâmetros inválidos. O cliente deve corrigir e reenviar a requisição.
401 - A solicitação requer autenticação. O token de acesso está ausente, inválido ou expirado.
404 - O recurso solicitado não foi encontrado. Pode indicar que o número de telefone ou o usuário não existem na base de dados.
500- Erro interno do servidor. Um problema inesperado ocorreu no processamento da solicitação.
504 - O servidor não conseguiu receber uma resposta a tempo para completar a solicitação. Recomenda-se tentar novamente.
Caso ainda restem dúvidas, baixe o PDF que contém o tutorial de consumo da API, que explica passo a passo como utiliza-la.
#!/bin/bash
# URL de obtenção do token
url_token="https://api.claro.com.br/oauth2/v1/token"
url_kyc="https://api.claro.com.br/number-recycling/v0.1/check"
# Credenciais
key="XXXXXXXXXXXXXXXXXXXXXXXXX"
secret="XXXXXXXXXXXXXXXXXXXXX"
# Dados do cliente para validação
phoneNumber="+5511999999999"
specifiedDate="123456789"
# Gerar senha em base64
senha=$(echo -n "$key:$secret" | base64)
# Requisição para obter o token de acesso
token=$(curl -s -X POST "$url_token" \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H "Authorization: Basic $senha" \
-d 'grant_type=client_credentials' | jq -r .access_token)
# Requisição para validar o KYC
curl -X POST "$url_kyc" \
-H "Authorization: Bearer $token" \
-H "Content-Type: application/json" \
-H "cache-control: no-cache" \
-d '{
"phoneNumber": "'"$phoneNumber"'",
"specifiedDate": "'"$specifiedDate"'"
}'
Plano Trial
Para você começar a desenvolver já!
•1.000 solicitações gratuitas
• Período de 3 meses
• Relatório de consumo
Plano Pay Per Use
Após o desenvolvimento
A melhor escolha para o seu negócio. Depois de testar nosso teste, você pode começar a utilizar nosso plano de produção, cobrado com base no consumo de acordo com suas solicitações.