Contribuyente por identificacion GET

Devuelve los datos de un contribuyente del SRI por cedula, RUC o pasaporte: nombre o razon social, regimen, actividad, representantes legales, establecimientos y estado tributario.

GET /v1/consultas/contribuyentes/{identificacion}

La respuesta es plana. Los valores reales dependen de lo que devuelva el SRI en cada consulta.

Parametros#

curl -s "https://staging-api.mynexusapi.com/v1/consultas/contribuyentes/1760013210001?fusionar=true" \
  -H "X-Api-Key: $ECUAFACT_API_KEY"

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", apiKey);

string json = await http.GetStringAsync(
    "https://staging-api.mynexusapi.com/v1/consultas/contribuyentes/1760013210001?fusionar=true");
Console.WriteLine(json);

import os, requests
r = requests.get(
    "https://staging-api.mynexusapi.com/v1/consultas/contribuyentes/1760013210001",
    headers={"X-Api-Key": os.environ["ECUAFACT_API_KEY"]},
    params={"fusionar": "true"}, timeout=30)
print(r.status_code, r.text)

const url = new URL('https://staging-api.mynexusapi.com/v1/consultas/contribuyentes/1760013210001');
url.search = new URLSearchParams({ fusionar: 'true' });
const res = await fetch(url, { headers: { 'X-Api-Key': process.env.ECUAFACT_API_KEY } });
console.log(res.status, await res.text());

<?php
$ch = curl_init('https://staging-api.mynexusapi.com/v1/consultas/contribuyentes/1760013210001?fusionar=true');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('ECUAFACT_API_KEY')],
]);
$respuesta = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . ' ' . $respuesta;
curl_close($ch);

HttpClient cliente = HttpClient.newHttpClient();
HttpRequest peticion = HttpRequest.newBuilder()
    .uri(URI.create("https://staging-api.mynexusapi.com/v1/consultas/contribuyentes/1760013210001?fusionar=true"))
    .header("X-Api-Key", System.getenv("ECUAFACT_API_KEY"))
    .GET()
    .build();
HttpResponse<String> respuesta = cliente.send(peticion, HttpResponse.BodyHandlers.ofString());
System.out.println(respuesta.statusCode() + " " + respuesta.body());

using Ecuafact.Sdk;
using Ecuafact.Sdk.Contracts;

// client: cliente EcuafactClient - ver SDK .NET
ContribuyenteConsulta contribuyente = await client.ConsultarContribuyenteAsync("1760013210001", fusionar: true);
Console.WriteLine(contribuyente.RazonSocial + " " + contribuyente.Estado);

from ecuafact import EcuafactClient

# client: cliente EcuafactClient - ver SDK Python
contribuyente = client.consultar_contribuyente("1760013210001")
print(contribuyente.razon_social, contribuyente.estado)

import { EcuafactClient } from "@ecuafact/sdk";

// client: cliente EcuafactClient - ver SDK Node.js
const contribuyente = await client.consultarContribuyente("1760013210001");
console.log(contribuyente.razonSocial, contribuyente.estado);

<?php
use Ecuafact\Sdk\EcuafactClient;

// $client: cliente EcuafactClient - ver SDK PHP
$contribuyente = $client->consultarContribuyente('1760013210001');
echo $contribuyente->razonSocial . ' ' . $contribuyente->estado;

import com.ecuafact.sdk.EcuafactClient;

// client: cliente EcuafactClient - ver SDK Java
ContribuyenteConsulta contribuyente = client.consultarContribuyente("1760013210001");
System.out.println(contribuyente.razonSocial() + " " + contribuyente.estado());

{
  "identificacion": "1760013210001",
  "tipoIdentificacion": "RucSociedadPublica",
  "nombreCompleto": "RAZON SOCIAL DEL CONTRIBUYENTE",
  "razonSocial": "RAZON SOCIAL DEL CONTRIBUYENTE",
  "nombreComercial": null,
  "clase": "SociedadPublica",
  "estado": "ACTIVO",
  "regimen": "GENERAL",
  "actividadEconomicaPrincipal": "ACTIVIDADES DE SERVICIOS",
  "obligadoLlevarContabilidad": true,
  "agenteRetencion": false,
  "contribuyenteEspecial": false,
  "fechaInicioActividades": "2000-01-01T00:00:00",
  "fechaCese": null,
  "fechaReinicioActividades": null,
  "fechaActualizacion": "2026-01-01T00:00:00",
  "representantesLegales": [ { "identificacion": "1712345678", "nombre": "PEREZ LOPEZ JUAN" } ],
  "establecimientos": [
    { "numero": "001", "nombreComercial": "SUCURSAL CENTRO", "tipo": "MATRIZ",
      "direccionCompleta": "AV. PRINCIPAL 123", "estado": "ABIERTO", "esMatriz": true }
  ],
  "estadoTributario": {
    "tieneDeuda": false, "tieneImpugnacion": false, "tieneRemision": false,
    "resumenDeuda": null, "resumenImpugnacion": null, "resumenRemision": null,
    "consultadoEn": "2026-09-30T08:00:00"
  },
  "fuenteOrigen": "SriCatastro",
  "consultadoEn": "2026-09-30T08:00:00"
}

Respuesta#

Estados de este endpoint#

Esta consulta no consume cupo de documentos. El catalogo completo esta en Errores.

Siguientes pasos#

• Errores