Português
EspañolEnglishPortuguêsFilipino
Criar chave grátis
Colombia · co_supersociedades_obligated_nit
OpenAPI

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

Publicador
Superintendencia de Sociedades, Colombia
Cobertura
Companies in the published obligated/supervised entity list.
Significado do 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.
Padrão aceito
^\d{6,10}$
Normalização
coNit
Quantidade de registros
many
Licença
A permissão de reutilização não foi verificada. Acesso público não equivale a uma licença de reutilização.

Limitações conhecidas

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

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

Exemplo de requisição

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

[].check_digit string obrigatório

Publisher identifier check digit.

[].company_name string obrigatório

Company name published by the authority.

[].supervision_status string obrigatório

Published Supersociedades supervision status.

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

[].judicial_address string obrigatório

Declared address for judicial notifications.

[].judicial_department string obrigatório

Published judicial-notification department.

[].judicial_city string obrigatório

Published judicial-notification city.

[].notification_email string obrigatório

Company-declared judicial notification email; not independently verified.

[].cut_date string obrigatório

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

[].upstream_layout string obrigatório

STANDARD or STATUS_ADDRESS_SWAPPED; identifies the deterministic 2025 layout repair.

STANDARD · STATUS_ADDRESS_SWAPPED

[].raw_estado string obrigatório

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

[].raw_direccion_judicial string obrigatório

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

[].entity_type string obrigatório

LEGAL_ENTITY scope marker added by the importer.

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."
      },
      "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.
Nenhum corpo de resposta documentado.
401Missing or invalid API key. Authenticate before retrying.
Nenhum corpo de resposta documentado.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
Nenhum corpo de resposta documentado.
409Source generation changed during paginated retrieval. Restart from offset 0.
Nenhum corpo de resposta documentado.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
Nenhum corpo de resposta documentado.
503Source unavailable. Report unavailable, not an empty result.
Nenhum corpo de resposta documentado.
Exemplo JSON

Exemplo ilustrativo do esquema. Não é uma resposta ao vivo.

[
  {
    "nit": "string",
    "check_digit": "string",
    "company_name": "string",
    "supervision_status": "INSPECCIÓN",
    "judicial_address": "string",
    "judicial_department": "string",
    "judicial_city": "string",
    "notification_email": "string",
    "cut_date": "string",
    "upstream_layout": "STANDARD",
    "raw_estado": "string",
    "raw_direccion_judicial": "string",
    "entity_type": "string"
  }
]

Procedência e limitações

A cobertura varia por país e fonte pública. Um campo ausente não comprova que o fato não exista. Os registros públicos podem ter atrasos ou erros; revise as evidências e a data da fonte antes de usar um resultado.

Esc