ecuadorapi
DocumentaciónAPI v1

Empresas

Agente de retención

Indica si el contribuyente consta como agente de retención.

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

Parámetro de la URL

rucstringObligatorio

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

Ejemplo ficticio: 1790012345001

Solicitud cURL

Configura ECUADORAPI_KEY en tu servidor. No la publiques en el navegador.

curl --request GET "https://api.ecuadorapi.com/api/v1/rucs/1790012345001/agente-retencion" \
  --header "Authorization: Bearer $ECUADORAPI_KEY" \
  --header "Accept: application/json" \
  --max-time 60

Respuesta de ejemplo

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

{
  "data": {
    "id": "1790012345001",
    "business_name": "EJEMPLO COMERCIAL S.A.",
    "status": "ACTIVO",
    "is_withholding_agent": true,
    "fetched_at": "2026-09-14T16:00:00Z"
  },
  "error": null,
  "message": null
}
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 consultar si un RUC es agente de retención
Ver errores y límites
Anterior