Contribuyentes

Consultar un RUC o una cédula en el SRI

GET
/v1/ec/taxpayers/{identification}

A quién pertenece una identificación: el nombre y, para un RUC (o una cédula cuyo titular tiene RUC), lo que registra el SRI: estado, régimen, obligaciones y establecimientos. Úsalo para completar un comprador o proveedor a partir de su identificación. Las respuestas se guardan 24 horas.

Autorización

AutorizaciónBearer <tu clave API>

Tu clave API: fb_sandbox_… emite en Sandbox, fb_test_… en test, el servicio de pruebas de la autoridad tributaria, y fb_live_… en live, su producción.

En: header

Parámetros de ruta

identification*string

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/ec/taxpayers/string"
{  "object": "taxpayer",  "identification": "string",  "identification_type": "ruc",  "name": "string",  "ruc": "string",  "registration": {    "status": "string",    "type": "string",    "regime": "general",    "keeps_accounting": true,    "withholding_agent": true,    "special_taxpayer": true,    "economic_activity": "string",    "activities_started_on": "2019-08-24",    "flagged": true,    "establishments": [      {        "code": "string",        "trade_name": "string",        "type": "string",        "address": "string",        "head_office": true,        "open": true      }    ]  },  "fetched_at": "2019-08-24T14:15:22Z",  "stale": true}