Endpoint: estados financieros de una sociedad por NIT

Con el NIT de una sociedad —con o sin dígito de verificación— devuelve los estados financieros que reportó a la Superintendencia de Sociedades en sus últimos cortes: un resumen con activos, pasivos, patrimonio, ingresos y utilidad del periodo, y el detalle de cada concepto del balance y del estado de resultados. Es el complemento financiero de /api/rues para una debida diligencia o un análisis de crédito. Solo reportan las sociedades vigiladas: una que no reporta responde con `reporta: false`, que es un hallazgo y se cobra.

POST/api/estados-financieros1 crédito

Los estados financieros que una sociedad reportó a la Superintendencia de Sociedades, por NIT (con o sin dígito de verificación): en sus 5 cortes más recientes, un resumen con activos, pasivos, patrimonio, ingresos de actividades ordinarias y ganancia (pérdida) del periodo, y el detalle de cada concepto del estado de situación financiera y del estado de resultados. ⚠️ Las cifras están en MILES de pesos (unidad: "miles"). Puede haber cortes intermedios (30-jun) además de los anuales; con anio se filtran, y si la sociedad reporta pero no ese año responde reporta: true, cortes: [] y sinInformeEnElAnio: true. Solo reportan las sociedades vigiladas por esa Superintendencia: una que no reporta (las vigiladas por la Superfinanciera, las ESAL, las personas naturales…) responde 200 con reporta: false y COBRA. No reportar no significa que la empresa no exista: para eso, /api/rues. Responde en ~1 s. Cuesta 1 crédito.

Para qué sirve, quién lo usa y cuánto cuesta: API de estados financieros.

Cuerpo de la solicitud

body (JSON)
{
  "nit": "900123456"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
nitobligatoriostringNIT de la sociedad, con o sin puntos y con o sin el dígito de verificación tras guion (900.123.456-7). Alias: `documento`, `nitEmpresa`.
aniointegerOpcional: solo los cortes de ese año (anual e intermedios).
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
curl -X POST 'https://placapi.com/api/estados-financieros' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"nit":"900123456"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/estados-financieros", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"nit":"900123456"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/estados-financieros",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"nit":"900123456"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "estados-financieros",
  "status": "ok",
  "data": {
    "nit": "900123456",
    "razonSocial": "EMPRESA DE PRUEBA S.A.S.",
    "reporta": true,
    "moneda": "COP",
    "unidad": "miles",
    "cortes": [
      {
        "fechaCorte": "2025-12-31",
        "periodo": "2025",
        "tipoInforme": "NIIF Plenas - Individual Grupo 1",
        "resumen": {
          "activos": 1000000,
          "pasivos": 400000,
          "patrimonio": 600000,
          "ingresos": 2500000,
          "utilidadNeta": 200000
        },
        "situacionFinanciera": [
          {
            "concepto": "Total de activos",
            "valor": 1000000
          },
          {
            "concepto": "Total pasivos",
            "valor": 400000
          },
          {
            "concepto": "Patrimonio total",
            "valor": 600000
          }
        ],
        "resultados": [
          {
            "concepto": "Ingresos de actividades ordinarias",
            "valor": 2500000
          },
          {
            "concepto": "Ganancia (pérdida)",
            "valor": 200000
          }
        ]
      }
    ]
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 16 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto