API de consulta de RG
O endpoint de RG recebe o número do documento de identidade e retorna os dados cadastrais vinculados, quando disponíveis, para conferência documental em fluxos autorizados e auditáveis. É um apoio à validação de identidade, sempre sob finalidade legítima.
Para que serve
- Conferência documental em onboarding autorizado.
- Validação cruzada de identidade (RG informado × cadastro).
- Apoio a due diligence e prevenção à fraude documental.
Requisição
Autentique com o header Authorization: Bearer — gere seu token no dashboard após ativar um plano.
curl -X POST "https://apiconsultas.xyz/api/v1/consultas/rg" \
-H "Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"rg":"123456789"}'const res = await fetch("https://apiconsultas.xyz/api/v1/consultas/rg", {
method: "POST",
headers: {
Authorization: "Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({"rg":"123456789"}),
});
const data = await res.json();<?php
$ch = curl_init("https://apiconsultas.xyz/api/v1/consultas/rg");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => '{"rg":"123456789"}',
]);
$data = json_decode(curl_exec($ch), true);Resposta (200)
Exemplo com valores ilustrativos. O nível de detalhe (dados completos ou mascarados) depende do seu plano.
{
"success": true,
"tipo_consulta": "rg",
"query": {
"termo_mascarado": "*****6789",
"finalidade": "validacao_cadastral"
},
"resultado_count": 1,
"data_quality": {
"sources_used": 1,
"confidence_score": 75
},
"data": [
{
"identificacao": {
"nome": "NOME DO TITULAR",
"documento": "123.***.**9-09",
"rg": "*****6789"
},
"localizacao": {
"cidade": "Belo Horizonte",
"estado": "MG"
}
}
],
"audit": {
"logged": true,
"timestamp": "2026-07-01T12:00:00.000Z"
},
"message": "Consulta realizada com sucesso."
}Campos retornados
| Campo | Descrição |
|---|---|
| identificacao.rg | Número de RG (mascarado conforme plano). |
| identificacao.nome / documento | Titular e CPF vinculados, quando disponíveis. |
| localizacao | Cidade/UF associadas, quando disponíveis. |
| data_quality | sources_used e confidence_score do resultado. |
Perguntas frequentes
Qual o formato aceito do RG?
De 4 a 14 caracteres alfanuméricos contendo ao menos um dígito. Pontuação é ignorada. Valores fora desse padrão retornam erro 400.
A cobertura de RG é a mesma do CPF?
Não necessariamente. O RG é emitido por órgão estadual e a disponibilidade varia; quando não há registro, a resposta retorna resultado_count 0.
Preciso de autorização para consultar RG?
O uso deve ter finalidade legítima (validação de identidade, antifraude, due diligence) e é registrado em auditoria, conforme a LGPD.
Endpoints relacionados
Integre consulta de rg hoje
Ative um plano a partir de R$ 10, gere seu token Bearer e comece a consultar em minutos. Consultas ilimitadas enquanto o plano estiver ativo.