Consultar un RUC o una cédula

Cuando tu cliente te da su RUC o su cédula, no le pidas nada más: consúltalo.

curl https://api.fiscalbase.io/v1/ec/taxpayers/1790012345001 \
  -H "Authorization: Bearer $FISCALBASE_API_KEY"

{
  "object": "taxpayer",
  "identification": "1790012345001",
  "identification_type": "ruc",
  "name": "FERRETERIA EL SOL S.A.",
  "ruc": "1790012345001",
  "registration": {
    "status": "ACTIVO",
    "regime": "general",
    "keeps_accounting": true,
    "withholding_agent": true,
    "special_taxpayer": false,
    "flagged": false,
    "establishments": [
      {
        "code": "001",
        "address": "PICHINCHA / QUITO / …",
        "head_office": true,
        "open": true
      }
    ]
  },
  "fetched_at": "2026-09-29T14:02:11Z",
  "stale": false
}

Un solo endpoint para ambas identificaciones:

• Con un RUC (13 dígitos), name es la razón social y registration lo que el SRI registra de él.
• Con una cédula (10 dígitos), name es el nombre completo del titular, apellidos primero. Si esa persona tiene RUC, ruc y registration lo traen; si no, son null.

Para qué sirveCopiar enlace a esta sección

• Completar un comprador o proveedor: pon name en buyer.name y tu factura sale con el nombre exacto del SRI.
• Saber si te retiene: withholding_agent y special_taxpayer te dicen si tu cliente debe emitirte una retención.
• Evitar problemas: flagged indica que el SRI marcó el RUC como empresa fantasma o con transacciones inexistentes.

Si el SRI no respondeCopiar enlace a esta sección

Guardamos cada respuesta 24 horas. Si el SRI no responde y tenemos una respuesta anterior, te la damos con "stale": true y su fetched_at. Si no tenemos ninguna, respondemos 503. Una identificación que el SRI no conoce responde 404.

No guardamos ni devolvemos datos personales que el SRI publica y que tus comprobantes no necesitan, como los representantes legales.