apifactura te devuelve la razón social, el estado, la condición y el domicilio de cualquier RUC —y el nombre de un DNI— en tiempo real. Ideal para tu checkout, tu facturación electrónica y el alta de clientes.
La información sale directo de la Consulta RUC de SUNAT. Sin bases desactualizadas.
REST + JSON. Sin SDK ni instalaciones. Funciona con cualquier lenguaje: PHP, JS, Python…
Empiezas con 100 consultas gratis y recargas por paquetes. Sin mensualidad obligatoria.
De cero a tu primera consulta en minutos.
Crea tu cuenta en FacturaCrece y genera tu llave. Vienen 100 consultas gratis.
Envía el RUC o DNI a /v1/consultar con tu llave en la cabecera.
Te devolvemos el nombre y los datos listos para tu comprobante o tu ficha de cliente.
Toda petición lleva tu API key como Bearer token en la cabecera Authorization.
# Base URL https://api.facturacrece.com # En cada llamada Authorization: Bearer TU_API_KEY
Dos endpoints: consultar un documento y ver tu saldo.
| Campo | Tipo | Descripción |
|---|---|---|
tipo | string | «RUC» o «DNI». |
numero | string | 11 dígitos para RUC, 8 para DNI. |
curl -X POST https://api.facturacrece.com/v1/consultar \ -H "Authorization: Bearer TU_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tipo":"RUC","numero":"20512345678"}'
$ch = curl_init("https://api.facturacrece.com/v1/consultar"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer TU_API_KEY", "Content-Type: application/json", ], CURLOPT_POSTFIELDS => json_encode(["tipo"=>"RUC", "numero"=>"20512345678"]), ]); $data = json_decode(curl_exec($ch), true);
const r = await fetch("https://api.facturacrece.com/v1/consultar", { method: "POST", headers: { "Authorization": "Bearer TU_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ tipo: "RUC", numero: "20512345678" }) }); const data = await r.json();
Respuesta (RUC)
{
"ok": true,
"tipo": "RUC",
"numero": "20512345678",
"nombre": "EMPRESA EJEMPLO S.A.C.",
"nombre_comercial": null,
"direccion": "AV. EJEMPLO 123, LIMA - LIMA - LIMA",
"estado": "ACTIVO",
"condicion": "HABIDO",
"representantes": [
{ "tipo_de_documento": "DNI", "numero_de_documento": "41379713",
"nombre": "JUAN PEREZ QUISPE", "cargo": "GERENTE GENERAL" }
],
"via": "sunat",
"creditos_restantes": 4211
}
Respuesta (DNI)
{
"ok": true,
"tipo": "DNI",
"numero": "41379713",
"nombre": "JUAN PEREZ QUISPE",
"via": "sunat-ruc10",
"creditos_restantes": 4210
}
El nombre de un DNI se obtiene si la persona tiene RUC 10. Si no, la respuesta indica que debe completarse a mano.
curl https://api.facturacrece.com/v1/saldo \
-H "Authorization: Bearer TU_API_KEY"
Respuesta
{
"ok": true,
"cliente": "Mi Empresa",
"creditos_restantes": 4210,
"gratis": 100,
"comprados": 10000,
"usados": 5890
}
| Código | Significado |
|---|---|
200 | Consulta resuelta. Revisa ok: true con datos, o false con error. |
401 | Falta la API key o es inválida. |
402 | Sin créditos. La respuesta trae los planes en comprar. |
422 | Falta tipo o numero, o el formato es incorrecto. |
429 | Demasiadas consultas por minuto. Espera unos segundos. |
Empiezas gratis. Cuando necesitas más, recargas por paquetes. El doble de consultas por el doble de precio.
consultas incluidas al crear tu cuenta. Sin tarjeta.
| Paquete | Consultas | Precio |
|---|---|---|
| Inicial | 10 000 | S/ 50 |
| Crece | 20 000 | S/ 100 |
| Pro | 40 000 | S/ 200 |
| Negocio | 80 000 | S/ 400 |
| Volumen | 160 000 | S/ 800 |
Los créditos no vencen. Cada consulta con resultado descuenta 1 crédito; una consulta repetida del mismo documento se sirve de caché el mismo día.
Comprar un paqueteDe la Consulta RUC pública de SUNAT, en el momento de la llamada. Por eso el estado y la condición están al día.
Sí. Si la persona tiene RUC 10, te devolvemos su nombre. Si no lo tiene, la respuesta lo indica para que el usuario lo escriba.
Creas tu cuenta en FacturaCrece y generas la llave desde tu panel. Incluye 100 consultas gratis para probar.
El endpoint responde con código 402 y te muestra los planes. Compras un paquete y sigues al instante.
Sí, para proteger el servicio: hasta 60 consultas por minuto por cuenta. Si necesitas más, escríbenos.
Integra apifactura en tu checkout o tu facturación hoy mismo.
Obtener mi API key