Saltar al contenido
ecuadorapi
Obtener API key
Catálogo de RUCs y precios

RUCs

Datos de un RUC

Razón social, estado, actividad económica y condiciones de agente de retención y contribuyente especial.

GET
/rucs/{ruc}
Precio de lista por consulta con API key. Los errores no descuentan saldo.

Autenticación: Authorization: Bearer. Cómo usar tu API key

Parámetros

rucstringObligatorio · URL

Número de RUC (13 dígitos). Reemplaza {ruc} en la URL por el dato que quieres consultar.

Ejemplo ficticio: 1790012345001

Ejemplo de solicitud

Solicitud cURLbash
curl "https://api.ecuadorapi.com/api/v1/rucs/1790012345001" \
  -H "Authorization: Bearer $ECUADORAPI_KEY"

Ejecuta desde tu terminal. Configura ECUADORAPI_KEY en el entorno. Nunca publiques tu clave en el navegador.

Respuesta

JSON con datos ficticios. Los valores cambian según la consulta.

Respuesta de ejemplojson
{
  "data": {
    "id": "1790012345001",
    "business_name": "EJEMPLO COMERCIAL S.A.",
    "status": "ACTIVO",
    "taxpayer_type": "SOCIEDAD",
    "is_withholding_agent": true,
    "is_special_taxpayer": false,
    "economic_activity": "VENTA AL POR MENOR DE OTROS PRODUCTOS",
    "start_date": "2015-03-01",
    "fetched_at": "2026-06-20T16:00:00Z"
  },
  "error": null,
  "message": null
}

Qué significan los campos

Las claves del JSON están en inglés. Aquí tienes su significado en español; utiliza las claves originales en tu integración.

La consulta principal incluye is_withholding_agent e is_special_taxpayer en la misma respuesta. Sus endpoints independientes siguen disponibles si solo necesitas una de estas condiciones.

El nombre comercial, la dirección de matriz y el listado se obtienen en el endpoint de establecimientos. La consulta principal no incluye trade_name ni address.

Clave dentro de dataSignificado en españolCómo interpretarla
idNúmero de RUCIdentificador consultado, de 13 dígitos.
business_nameRazón socialNombre registrado del contribuyente.
statusEstado del contribuyentePor ejemplo, ACTIVO. Este estado no indica por sí solo si es agente de retención o contribuyente especial.
is_withholding_agentEs agente de retenciónWithholding agent significa agente de retención. true: consta como agente de retención; false: no consta con esa condición.
is_special_taxpayerEs contribuyente especialSpecial taxpayer significa contribuyente especial. true: consta como contribuyente especial; false: no consta con esa condición.
taxpayer_typeTipo de contribuyentePor ejemplo, SOCIEDAD o PERSONA NATURAL.
economic_activityActividad económicaActividad principal registrada.
start_dateInicio de actividadesFecha de inicio en formato YYYY-MM-DD, cuando está disponible.
fetched_atFecha de consultaFecha y hora de obtención de los datos, en formato ISO 8601.

null indica que un valor no está disponible.

Qué consulta cada endpoint de RUC

Las rutas usan el mismo RUC de 13 dígitos. Cada consulta tiene su propia respuesta y precio; revisa la ficha del endpoint que necesitas.
ConsultaRuta GETQué devuelve
Datos de un RUC/api/v1/rucs/{ruc}Ficha general con razón social, estado, actividad y ambas condiciones tributarias.
Agente de retención/api/v1/rucs/{ruc}/agente-retencionis_withholding_agent: condición de agente de retención.
Contribuyente especial/api/v1/rucs/{ruc}/contribuyente-especialis_special_taxpayer: condición de contribuyente especial.
Establecimientos por RUC/api/v1/rucs/{ruc}/establecimientoscount y establishments: cantidad y listado de establecimientos.
Guía de integración paso a paso
Sigue ejemplos en cURL, JavaScript, Python y PHP, interpreta la respuesta y prepara el manejo de errores.
Cómo integrar una API de RUC de Ecuador
Ver errores y límites
Siguiente