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.

Contrato de la fuente

Publicador: Superintendencia de Sociedades, Colombia
Cobertura: Companies in the published obligated/supervised entity list.
Qué representa un registro: A company observation at the reporting cut date with judicial notification attributes.
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: No se ha verificado el permiso de reutilización. El acceso público no equivale a una licencia de reutilización.

Limitaciones conocidas

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

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

Ejemplo de solicitud

curl https://api.latinfo.dev/co/supersociedades/obligated/nit/890200122 \
  -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.

[].check_digit string obligatorio

Publisher identifier check digit.

[].company_name string obligatorio

Company name published by the authority.

[].supervision_status string obligatorio

Published Supersociedades supervision status.

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

[].judicial_address string obligatorio

Declared address for judicial notifications.

[].judicial_department string obligatorio

Published judicial-notification department.

[].judicial_city string obligatorio

Published judicial-notification city.

[].notification_email string obligatorio

Company-declared judicial notification email; not independently verified.

[].cut_date string obligatorio

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

[].upstream_layout string obligatorio

STANDARD or STATUS_ADDRESS_SWAPPED; identifies the deterministic 2025 layout repair.

STANDARD · STATUS_ADDRESS_SWAPPED

[].raw_estado string obligatorio

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

[].raw_direccion_judicial string obligatorio

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

[].entity_type string obligatorio

LEGAL_ENTITY scope marker added by the importer.

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."
      },
      "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.