Inicio API de Consulta de RUC
API DE CONTRIBUYENTES

API de Consulta de RUC

Consulta información asociada a un RUC e incorpora el resultado directamente en tus sistemas empresariales.

Solicitar acceso Ver documentación
Acceso seguro Integración REST Consumo medible
Disponible

Endpoint principal

POST/v1/consultas/ruc
Respuesta de ejemplo
{
  "success": true,
  "data": {
    "ruc": "0000000000001",
    "razonSocial": "CONTRIBUYENTE DE EJEMPLO",
    "estado": "ACTIVO",
    "tipoContribuyente": "PERSONA NATURAL",
    "regimen": "GENERAL"
  }
}
Los ejemplos utilizan información ficticia o enmascarada.

UNA INTEGRACIÓN, MENOS FRICCIÓN

Información tributaria integrada a tu operación

Automatiza consultas de contribuyentes mediante una respuesta uniforme y fácil de procesar. La información disponible dependerá de la fuente autorizada y del alcance contratado. ValidaEC es un servicio independiente y no representa al SRI.

01

Consulta por RUC

Envía el número de identificación tributaria desde cualquier sistema.

02

Respuesta normalizada

Recibe la información disponible en formato JSON.

03

Menos digitación

Completa y valida registros empresariales con menos tareas manuales.

04

Acceso controlado

Utiliza API keys, permisos y límites técnicos de seguridad.

DATOS DISPONIBLES

Información que devuelve esta API

Este es el contrato público completo. Los campos vacíos se omiten cuando la fuente no dispone de información y nunca exponemos metadatos internos del proveedor.

ruc

Número de RUC consultado.

razonSocial

Razón social registrada.

nombreComercial

Nombre comercial disponible.

estado

Estado actual del contribuyente.

actividadEconomicaPrincipal

Actividad económica principal.

tipoContribuyente

Tipo de contribuyente.

regimen

Régimen tributario registrado.

obligadoLlevarContabilidad

Obligación de llevar contabilidad.

agenteRetencion

Condición de agente de retención.

contribuyenteEspecial

Condición de contribuyente especial.

categoria

Categoría registrada cuando está disponible.

contribuyenteFantasma

Indicador disponible en la fuente.

transaccionesInexistentes

Indicador de transacciones inexistentes.

direccion

Dirección registrada del contribuyente.

fechaActualizacion

Fecha de actualización disponible.

fechaInicioActividades

Fecha de inicio de actividades.

fechaCese

Fecha de cese cuando corresponde.

fechaReinicioActividades

Fecha de reinicio cuando corresponde.

identificacionRepresentanteLegal

Identificación del representante legal.

nombreRepresentanteLegal

Nombre del representante legal.

motivoCancelacionSuspension

Motivo disponible para estados suspendidos o cancelados.

establecimientos[].numeroEstablecimiento

Número asignado al establecimiento.

establecimientos[].nombreFantasiaComercial

Nombre de fantasía comercial.

establecimientos[].direccionCompleta

Dirección completa del establecimiento.

establecimientos[].estado

Estado abierto o cerrado.

establecimientos[].tipoEstablecimiento

Tipo de establecimiento registrado.

CASOS DE USO

Integra la consulta en tus procesos

Registro de proveedoresOnboarding empresarialFacturación y ventasSistemas contables

HABLEMOS DE TU PROYECTO

Solicitar acceso

Escríbenos y te ayudaremos a elegir la solución adecuada para tu empresa.

Crear cuenta