RUCs

Establecimientos por RUC

Lista de establecimientos registrados, dirección, estado y matriz.

GET

/rucs/{ruc}/establecimientos

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/establecimientos" \
  -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",
    "count": 1,
    "establishments": [
      {
        "commercial_name": "EJEMPLO",
        "establishment_number": "001",
        "type": "MAT",
        "address": "AV. AMAZONAS Y NACIONES UNIDAS, QUITO",
        "status": "ABIERTO",
        "is_headquarters": true
      }
    ],
    "fetched_at": "2026-10-16T16: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.

Este endpoint entrega el listado, el nombre comercial y la dirección de cada establecimiento. Usa is_headquarters para identificar la matriz.

count: 0 y establishments: [] indican una consulta exitosa sin establecimientos. Un error 502 o 503 no debe interpretarse como una lista vacía.

Clave dentro de data	Significado en español	Cómo interpretarla
`id`	Número de RUC	Identificador consultado, de 13 dígitos.
`count`	Cantidad de establecimientos	Número de elementos devueltos en establishments.
`establishments`	Establecimientos	Lista de establecimientos registrados. Puede estar vacía.
`establishments[].establishment_number`	Número de establecimiento	Código del establecimiento, por ejemplo 001. Se entrega como texto para conservar los ceros iniciales.
`establishments[].commercial_name`	Nombre comercial	Nombre comercial del establecimiento, cuando está disponible.
`establishments[].type`	Tipo de establecimiento	Tipo registrado del establecimiento, cuando está disponible.
`establishments[].address`	Dirección	Dirección de este establecimiento.
`establishments[].status`	Estado del establecimiento	Por ejemplo, ABIERTO o CERRADO. Es distinto del estado del contribuyente.
`establishments[].is_headquarters`	Es la matriz	true identifica la matriz; false indica que el establecimiento no está marcado como matriz.
`fetched_at`	Fecha de consulta	Fecha y hora de obtención de los datos, en formato ISO 8601.

null indica que un valor no está disponible. En los campos con establishments[], la descripción corresponde a cada elemento de la lista.

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.

Consulta	Ruta GET	Qué 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-retencion`	is_withholding_agent: condición de agente de retención.
Contribuyente especial	`/api/v1/rucs/{ruc}/contribuyente-especial`	is_special_taxpayer: condición de contribuyente especial.
Establecimientos por RUC	`/api/v1/rucs/{ruc}/establecimientos`	count y establishments: cantidad y listado de establecimientos.

Ver errores y límites