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.

Kontrata ng source

Publisher: Superintendencia de Sociedades, Colombia
Saklaw: Partial coverage of corporate financial reporting companies.
Kahulugan ng tala: One original income-statement line item per filing, reporting basis, concept and period.
Identifier: Use the NIT body without check digit. coNit normalizes accepted inputs to the zero-padded stored body; keep it as a string.
Tinatanggap na pattern: ^\d{6,10}$
Normalization: coNit
Bilang ng mga tala: many
Lisensya: CC BY-SA 4.0

Mga kilalang limitasyon

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.

Kontrata ng source para sa mga agent · Dokumentasyon ng source

Kailangan ng authentication. Gumagamit ang REST request ng Latinfo api key. Idinaragdag ng console ang authorization header at hindi iniimbak ang key.

Mga parameter

nitstringpathkailangan

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.

Halimbawa ng request

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

Mga tugon

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

Mga header ng tugon

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

Mga field ng tugon

[].nit string kailangan

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 kailangan

Publisher filing-instance code (codigo_instancia).

[].filing_number string kailangan

Publisher filing identifier (numero_radicado).

[].entry_point_id string kailangan

Reporting entry-point identifier.

[].entry_point string kailangan

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

[].taxonomy_id string kailangan

Reporting taxonomy identifier.

[].taxonomy string kailangan

Reporting taxonomy label.

[].cut_date string kailangan

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

[].concept string kailangan

Original financial line-item concept.

[].period string kailangan

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

[].amount string kailangan

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 kailangan

COP: Colombian pesos.

[].unit string kailangan

THOUSANDS: figures are thousands of Colombian pesos.

[].entity_type string kailangan

LEGAL_ENTITY scope marker added by the importer.

[].row_hash string kailangan

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

Response schema

{
  "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.