Lookup supersociedades · income by NIT

GET https://api.latinfo.dev/co/supersociedades/income/nit/{nit}

One original income-statement line item per filing, reporting basis, concept and period. Coverage: Partial coverage of corporate financial reporting companies. Use the NIT body without check digit. coNit normalizes accepted inputs to the zero-padded stored body; keep it as a string. Amounts are thousands of COP. Preserve separate filings, reporting bases and comparative periods; do not sum indiscriminately. Reuse retains publisher attribution and CC BY-SA 4.0 license obligations; this dataset is not mapped to universal normalized financial metrics. Returns all records as an array. Import time is not observation time; inspect freshness headers. Add limit (1–500) and offset to retrieve an explicit page; without them the complete original array is returned. X-Total-Count gives the exact row count; follow Link rel=next to retrieve all pages.

Contrato de la fuente

Publicador: Superintendencia de Sociedades, Colombia
Cobertura: Partial coverage of corporate financial reporting companies.
Qué representa un registro: One original income-statement line item per filing, reporting basis, concept and period.
Identificador: Use the NIT body without check digit. coNit normalizes accepted inputs to the zero-padded stored body; keep it as a string.
Patrón admitido: ^\d{6,10}$
Normalización: coNit
Cantidad de registros: many
Licencia: CC BY-SA 4.0

Limitaciones conocidas

Amounts are thousands of COP. Preserve separate filings, reporting bases and comparative periods; do not sum indiscriminately.
Reuse retains publisher attribution and CC BY-SA 4.0 license obligations; this dataset is not mapped to universal normalized financial metrics.

Contrato de la fuente para agentes · Documentación de la fuente

Requiere autenticación. Las solicitudes REST usan una clave de api de Latinfo. La consola agrega el encabezado de autorización y no guarda la clave.

Parámetros

nitstringpathobligatorio

NIT in the source's normalized format. Keep identifiers as strings; preserve leading zeros.

Example: 0900328533

limitintegerquery

Optional page size. Supplying limit or offset enables explicit pagination; default page size is 100.

offsetintegerquery

Row offset, default 0. Keep the same source generation while collecting pages.

generationstringquery

Opaque source-generation guard, automatically included in the next-page Link. A changed generation returns 409; restart retrieval.

Ejemplo de solicitud

curl https://api.latinfo.dev/co/supersociedades/income/nit/0900328533 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respuestas

200Published source records. Missing data is not a clearance or a negative finding.

Encabezados de la respuesta

X-Latinfo-Imported-At

Import time, not the date of the government observation.

X-Source-Updated-At

Publisher update time, when known.

X-Latest-Observation-At

Latest date in returned records, when known.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN

X-Credits-Cost

Actual credits charged for this request.

X-Source-Generation

Opaque immutable source generation. Follow the guarded next-page Link when collecting a history.

X-Total-Count

Exact row count for this identifier when pagination is requested.

X-Page-Offset

integer

X-Page-Limit

integer

Link

Next page URL, rel=next. Absent at the end.

Content-Type: application/json

Campos de la respuesta

[].nit string obligatorio

Use the NIT body without check digit. coNit normalizes accepted inputs to the zero-padded stored body; keep it as a string.

[].instance_code string obligatorio

Publisher filing-instance code (codigo_instancia).

[].filing_number string obligatorio

Publisher filing identifier (numero_radicado).

[].entry_point_id string obligatorio

Reporting entry-point identifier.

[].entry_point string obligatorio

NIIF reporting basis; individual, separate, consolidated and combined filings remain distinct.

[].taxonomy_id string obligatorio

Reporting taxonomy identifier.

[].taxonomy string obligatorio

Reporting taxonomy label.

[].cut_date string obligatorio

Published cut date date. Format: YYYY-MM-DD.

[].concept string obligatorio

Original financial line-item concept.

[].period string obligatorio

Original reporting-period label; historical and comparative periods remain distinct.

[].amount string obligatorio

Original signed financial value at unchanged precision, in thousands of COP; never sum across reporting bases. Unit: thousands of COP.

thousands of COP

[].currency string obligatorio

COP: Colombian pesos.

[].unit string obligatorio

THOUSANDS: figures are thousands of Colombian pesos.

[].entity_type string obligatorio

LEGAL_ENTITY scope marker added by the importer.

[].row_hash string obligatorio

SHA-256 of the ordered original source values; preserves distinctions between filings.

Esquema de respuesta

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "nit": {
        "type": "string",
        "description": "Use the NIT body without check digit. coNit normalizes accepted inputs to the zero-padded stored body; keep it as a string."
      },
      "instance_code": {
        "type": "string",
        "description": "Publisher filing-instance code (codigo_instancia).",
        "x-latinfo-meaning": "text"
      },
      "filing_number": {
        "type": "string",
        "description": "Publisher filing identifier (numero_radicado).",
        "x-latinfo-meaning": "identifier"
      },
      "entry_point_id": {
        "type": "string",
        "description": "Reporting entry-point identifier.",
        "x-latinfo-meaning": "identifier"
      },
      "entry_point": {
        "type": "string",
        "description": "NIIF reporting basis; individual, separate, consolidated and combined filings remain distinct.",
        "x-latinfo-meaning": "text"
      },
      "taxonomy_id": {
        "type": "string",
        "description": "Reporting taxonomy identifier.",
        "x-latinfo-meaning": "identifier"
      },
      "taxonomy": {
        "type": "string",
        "description": "Reporting taxonomy label.",
        "x-latinfo-meaning": "text"
      },
      "cut_date": {
        "type": "string",
        "description": "Published cut date date. Format: YYYY-MM-DD.",
        "x-latinfo-meaning": "date"
      },
      "concept": {
        "type": "string",
        "description": "Original financial line-item concept.",
        "x-latinfo-meaning": "text"
      },
      "period": {
        "type": "string",
        "description": "Original reporting-period label; historical and comparative periods remain distinct.",
        "x-latinfo-meaning": "text"
      },
      "amount": {
        "type": "string",
        "description": "Original signed financial value at unchanged precision, in thousands of COP; never sum across reporting bases. Unit: thousands of COP.",
        "x-latinfo-meaning": "amount",
        "x-latinfo-unit": "thousands of COP"
      },
      "currency": {
        "type": "string",
        "description": "COP: Colombian pesos.",
        "x-latinfo-meaning": "code"
      },
      "unit": {
        "type": "string",
        "description": "THOUSANDS: figures are thousands of Colombian pesos.",
        "x-latinfo-meaning": "text"
      },
      "entity_type": {
        "type": "string",
        "description": "LEGAL_ENTITY scope marker added by the importer.",
        "x-latinfo-meaning": "text"
      },
      "row_hash": {
        "type": "string",
        "description": "SHA-256 of the ordered original source values; preserves distinctions between filings.",
        "x-latinfo-meaning": "identifier"
      }
    },
    "required": [
      "nit",
      "instance_code",
      "filing_number",
      "entry_point_id",
      "entry_point",
      "taxonomy_id",
      "taxonomy",
      "cut_date",
      "concept",
      "period",
      "amount",
      "currency",
      "unit",
      "entity_type",
      "row_hash"
    ],
    "additionalProperties": false
  }
}

400Invalid identifier or query. Correct the input before retrying.