API de estados financieros: balance y resultados de una empresa por NIT
PlacApi devuelve en JSON, en ~1 segundo, los estados financieros que una sociedad colombiana reportó a la Superintendencia de Sociedades en sus cinco cortes más recientes: un resumen con activos, pasivos, patrimonio, ingresos y utilidad del periodo, y el detalle de cada concepto del balance y del estado de resultados. Se consulta por NIT, con o sin dígito de verificación, y las cifras vienen en miles de pesos. Es el complemento financiero de la API del RUES para una debida diligencia o un análisis de crédito.
¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.
Qué problema resuelve
Para dar crédito a una empresa, aprobar un proveedor o evaluar una contraparte hay que ver sus números, y pedírselos al cliente es lento y no garantiza que sean los que reportó. Reunir los estados financieros de una sociedad y normalizarlos a mano lleva horas por empresa. Este endpoint entrega el resumen y el detalle ya estructurados, corte por corte.
Para quién sirve
Fintechs y entidades que originan crédito empresarial, áreas de compras y de riesgo de proveedores, aseguradoras de crédito y de cumplimiento, factoring y plataformas B2B que evalúan a sus clientes.
Datos requeridos
- nit — NIT de la sociedad; se aceptan puntos y el dígito de verificación tras guion (900.123.456-7).
- anio — opcional: solo los cortes de ese año.
Fuentes y cobertura
- Superintendencia de SociedadesEstados financieros reportados por las sociedades vigiladas: estado de situación financiera y estado de resultados, por corte, bajo el marco NIIF que le aplica a cada una.
¿Cuánto cuesta consultar los estados financieros de una empresa por API?
1 crédito por consulta, y un «no reporta» también se cobra. Una consulta servida de caché no cobra.
¿Cómo consultar el balance de una empresa colombiana por NIT?
Con un POST a /api/estados-financieros enviando el nit. La respuesta trae el resumen y el detalle de sus últimos cortes.
Ejemplo de solicitud
POST https://placapi.com/api/estados-financieros. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.
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"}'Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/estados-financieros.
Ejemplo de respuesta
Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).
{
"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",
"resumen": {
"activos": 1000000,
"pasivos": 400000,
"patrimonio": 600000,
"ingresos": 2500000,
"utilidadNeta": 200000
}
}
]
}
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| reporta | boolean | true si la sociedad tiene estados financieros reportados. false es una respuesta válida y se cobra: no reporta a esa Superintendencia. |
| unidad | string | Unidad de las cifras: miles de pesos. |
| cortes[].resumen | object | Activos, pasivos, patrimonio, ingresos de actividades ordinarias y ganancia (pérdida) del periodo. |
| cortes[].situacionFinanciera | array | Cada concepto del estado de situación financiera con su valor. |
| cortes[].resultados | array | Cada concepto del estado de resultados con su valor. |
Tiempo de respuesta
~1 segundo.
Precio y cobro
1 crédito por consulta con datos, desde 349 COP. El precio por crédito baja por volumen: 349 COP desde 30, 249 COP desde 1.000, 149 COP desde 5.000, 139 COP desde 10.000, 119 COP desde 20.000, 99 COP desde 50.000. Los créditos se compran por adelantado (mínimo 30 = 10.470 COP), no vencen y no hay mensualidad. Por la web, el informe completo por placa cuesta 3 créditos. Solo se cobra cuando la consulta devuelve datos; por API, las consultas sin resultado (404) tienen 10 gratis al mes por cada tipo de respuesta sin datos y después cobran igual.
Caché y actualización
7 días: los estados financieros se reportan una o dos veces al año.
Seguridad y privacidad
La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.
Limitaciones y posibles errores
- Solo reportan las sociedades vigiladas por la Superintendencia de Sociedades: las vigiladas por la Superintendencia Financiera, las entidades sin ánimo de lucro y las personas naturales responden
reporta: false. Eso no significa que la empresa no exista: para eso está /api/rues. - Las cifras están en miles de pesos, tal como se reportan.
- Puede haber cortes intermedios (30 de junio) además de los anuales.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Otras preguntas frecuentes
¿En qué unidad vienen las cifras?
+
En miles de pesos colombianos, tal como las reporta la sociedad: un activo de 1.000.000 son mil millones de pesos.
¿Por qué una empresa grande puede responder `reporta: false`?
+
Porque no la vigila la Superintendencia de Sociedades: los bancos y aseguradoras reportan a la Superintendencia Financiera, por ejemplo.
Seguir explorando
Última revisión: 16 de octubre de 2026 · Versión de la API: v1 · Fuentes y metodología