API de Consulta de CPF

La Consulta Simple recibe solo el CPF (el número de identificación fiscal de personas físicas en Brasil) y devuelve nombre, género y fecha de nacimiento. El tiempo típico es ~150 ms (no es un SLA) y el costo es 1 crédito por CPF encontrado. La Consulta en Tiempo Real recibe el CPF y la fecha de nacimiento, consulta a la Receita Federal (la autoridad tributaria federal de Brasil) en el momento de la solicitud y devuelve la situación de registro, el año de fallecimiento (deathYear, entero o null) y el comprobante. El tiempo típico es de alrededor de 1 segundo (no es un SLA) y el costo es 1,5 créditos solo en la respuesta HTTP 200. La Consulta por Lote procesa hasta 10.000 CPFs por envío, con los mismos datos de la Consulta Simple. El tiempo del lote depende de cuántos CPFs vayan en el envío, y cada consulta queda en el mismo rango de la Consulta Simple. Las tres usan la misma clave de API y el mismo saldo de créditos.

No. Puedes consultar CPFs directamente en el dashboard, de uno en uno o subiendo un archivo .csv o .txt con hasta 10.000 CPFs. La API es para quienes quieren automatizar las consultas en su propio sistema.

La Consulta Simple y la Consulta por Lote responden desde la base de datos de CPFHub.io. La Consulta en Tiempo Real consulta a la Receita Federal en el momento de la solicitud y devuelve la situación de registro, el año de fallecimiento y el comprobante emitido por la Receita Federal.

Sí, a través de la Consulta en Tiempo Real. Informa si el CPF está regular, suspendido, pendiente de regularización, cancelado o nulo, o si el titular figura como fallecido. También devuelve el año de fallecimiento en el campo deathYear (entero o null) y la fecha y la hora de emisión del comprobante. deathYear es null cuando no hay fallecimiento registrado o cuando el valor recibido no es válido. No incluye el día ni el mes del fallecimiento. Para consultar, debes enviar la fecha de nacimiento del titular. La Consulta Simple no devuelve la situación de registro ni el año de fallecimiento.

En la Consulta en Tiempo Real, sí: el campo deathYear trae el año de fallecimiento, siempre presente, como entero o null. No incluye el día ni el mes. null aparece cuando no hay fallecimiento registrado o cuando el valor recibido no es válido (no tiene 4 dígitos, está fuera del rango entre 1900 y el año actual o es anterior al año de nacimiento). La Consulta Simple y la Consulta por Lote no devuelven este campo.

La Consulta Simple tiene un tiempo típico de ~150 ms. La Consulta en Tiempo Real tiene un tiempo típico de alrededor de 1 segundo, porque consulta a la Receita Federal en el momento de la solicitud. Son referencias típicas, no un SLA. En la Consulta por Lote, el tiempo depende de cuántos CPFs vayan en el envío, y cada consulta queda en el mismo rango de la Consulta Simple. La disponibilidad tiene un SLA por plan: 95% en Gratis, 99% en PRO y 99,9% en Enterprise.

Sí. Cada consulta se registra (CPF, resultado, fecha y cuenta) para fines de historial, cobro, auditoría y prevención de fraude, con un plazo de retención definido en la Política de Privacidad. A tu empresa, como controladora de los datos, le corresponde definir la base legal y la finalidad legítima de cada consulta.

Sí. Al crear una cuenta gratuita, sin tarjeta de crédito, recibes 50 créditos al mes. La clave de API queda disponible de inmediato en el dashboard.

En la Consulta Simple y en la Consulta por Lote, el crédito solo se consume cuando se encuentra el CPF, a razón de 1 crédito por CPF. Los CPFs no encontrados no se cobran. En la Consulta en Tiempo Real, el costo es de 1,5 créditos solo en la respuesta HTTP 200. Una fecha de nacimiento que no coincide responde HTTP 422 y no se cobra.

La facturación es mensual. El plan Gratis ofrece 50 créditos sin costo. El plan PRO empieza en R$ 19 por mes (reales brasileños, BRL), con 100 créditos, y tiene niveles de hasta 10.000 créditos. El crédito excedente cuesta de R$ 0,19 a R$ 0,10, según el nivel, y se cobra en la factura del mes siguiente. El plan Enterprise tiene precio personalizado.

No. El único límite es el saldo de créditos del plan: mientras haya saldo, puedes llamar a la API al ritmo que necesites. En el plan Gratis, las consultas se pausan cuando se agotan los 50 créditos mensuales. En los planes de pago, la API sigue respondiendo después del límite y el excedente se cobra en la factura del mes siguiente.