Lookup supersociedades · obligated by NIT

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

A company observation at the reporting cut date with judicial notification attributes. Coverage: Companies in the published obligated/supervised entity list. Use the NIT body without check digit. coNit normalizes accepted inputs to the zero-padded stored body; keep it as a string. The 2025 status/address repair is identified by upstream_layout; original cleaned columns remain available. 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: Companies in the published obligated/supervised entity list.
Kahulugan ng tala: A company observation at the reporting cut date with judicial notification attributes.
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: Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

The 2025 status/address repair is identified by upstream_layout; original cleaned columns remain available.

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: 890200122

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/obligated/nit/890200122 \
  -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.

[].check_digit string kailangan

Publisher identifier check digit.

[].company_name string kailangan

Company name published by the authority.

[].supervision_status string kailangan

Published Supersociedades supervision status.

INSPECCIÓN · VIGILANCIA · NUEVA · CAMARA COMERCIO INSPECCIÓN-VIGILANCIA-CONTROL · CONTROL

[].judicial_address string kailangan

Declared address for judicial notifications.

[].judicial_department string kailangan

Published judicial-notification department.

[].judicial_city string kailangan

Published judicial-notification city.

[].notification_email string kailangan

Company-declared judicial notification email; not independently verified.

[].cut_date string kailangan

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

[].upstream_layout string kailangan

STANDARD or STATUS_ADDRESS_SWAPPED; identifies the deterministic 2025 layout repair.

STANDARD · STATUS_ADDRESS_SWAPPED

[].raw_estado string kailangan

Cleaned original ESTADO column; retained separately from repaired supervision status.

[].raw_direccion_judicial string kailangan

Cleaned original judicial-address column; retained separately from repaired address.

[].entity_type string kailangan

LEGAL_ENTITY scope marker added by the importer.

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."
      },
      "check_digit": {
        "type": "string",
        "description": "Publisher identifier check digit.",
        "x-latinfo-meaning": "code"
      },
      "company_name": {
        "type": "string",
        "description": "Company name published by the authority.",
        "x-latinfo-meaning": "text"
      },
      "supervision_status": {
        "type": "string",
        "description": "Published Supersociedades supervision status.",
        "x-latinfo-meaning": "text",
        "enum": [
          "INSPECCIÓN",
          "VIGILANCIA",
          "NUEVA",
          "CAMARA COMERCIO INSPECCIÓN-VIGILANCIA-CONTROL",
          "CONTROL"
        ]
      },
      "judicial_address": {
        "type": "string",
        "description": "Declared address for judicial notifications.",
        "x-latinfo-meaning": "text"
      },
      "judicial_department": {
        "type": "string",
        "description": "Published judicial-notification department.",
        "x-latinfo-meaning": "text"
      },
      "judicial_city": {
        "type": "string",
        "description": "Published judicial-notification city.",
        "x-latinfo-meaning": "text"
      },
      "notification_email": {
        "type": "string",
        "description": "Company-declared judicial notification email; not independently verified.",
        "x-latinfo-meaning": "text"
      },
      "cut_date": {
        "type": "string",
        "description": "Published cut date date. Format: YYYY-MM-DD.",
        "x-latinfo-meaning": "date"
      },
      "upstream_layout": {
        "type": "string",
        "description": "STANDARD or STATUS_ADDRESS_SWAPPED; identifies the deterministic 2025 layout repair.",
        "x-latinfo-meaning": "text",
        "enum": [
          "STANDARD",
          "STATUS_ADDRESS_SWAPPED"
        ]
      },
      "raw_estado": {
        "type": "string",
        "description": "Cleaned original ESTADO column; retained separately from repaired supervision status.",
        "x-latinfo-meaning": "text"
      },
      "raw_direccion_judicial": {
        "type": "string",
        "description": "Cleaned original judicial-address column; retained separately from repaired address.",
        "x-latinfo-meaning": "text"
      },
      "entity_type": {
        "type": "string",
        "description": "LEGAL_ENTITY scope marker added by the importer.",
        "x-latinfo-meaning": "text"
      }
    },
    "required": [
      "nit",
      "check_digit",
      "company_name",
      "supervision_status",
      "judicial_address",
      "judicial_department",
      "judicial_city",
      "notification_email",
      "cut_date",
      "upstream_layout",
      "raw_estado",
      "raw_direccion_judicial",
      "entity_type"
    ],
    "additionalProperties": false
  }
}

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