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 da fonte

Publicador: Superintendencia de Sociedades, Colombia
Cobertura: Partial coverage of corporate financial reporting companies.
Significado do 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.
Padrão aceito: ^\d{6,10}$
Normalização: coNit
Quantidade de registros: many
Licença: CC BY-SA 4.0

Limitações conhecidas

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 da fonte para agentes · Documentação da fonte

Autenticação necessária. As requisições REST usam uma chave de api do Latinfo. O console adiciona o cabeçalho de autorização e não armazena a chave.

Parâmetros

nitstringpathobrigatório

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.

Exemplo de requisição

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

Respostas

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

Cabeçalhos da resposta

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 da resposta

[].nit string obrigatório

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 obrigatório

Publisher filing-instance code (codigo_instancia).

[].filing_number string obrigatório

Publisher filing identifier (numero_radicado).

[].entry_point_id string obrigatório

Reporting entry-point identifier.

[].entry_point string obrigatório

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

[].taxonomy_id string obrigatório

Reporting taxonomy identifier.

[].taxonomy string obrigatório

Reporting taxonomy label.

[].cut_date string obrigatório

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

[].concept string obrigatório

Original financial line-item concept.

[].period string obrigatório

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

[].amount string obrigatório

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 obrigatório

COP: Colombian pesos.

[].unit string obrigatório

THOUSANDS: figures are thousands of Colombian pesos.

[].entity_type string obrigatório

LEGAL_ENTITY scope marker added by the importer.

[].row_hash string obrigatório

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

Esquema de resposta

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