Universal company API · getUniversalCompany
OpenAPI

Universal LATAM company profile

GET https://api.latinfo.dev/v1/companies/{country}/{taxId}

Use the universal profile only for countries in the country parameter enum. For other published countries, choose a source-specific lookup from /catalog. A country with a published source does not necessarily have a certified universal profile.

Integration workflow

  1. With only a name, search the appropriate country registry and confirm the candidate. A name match is not a unique identity.
  2. Send country and taxId as strings. Keep leading zeros. Use the company tax identifier, never a DNI or a personal identifier.
  3. Read coverage for each module before interpreting its arrays. NO_RECORDS means no records in the checked sources; NOT_SUPPORTED means the module is not covered.
  4. Follow evidence_refs to evidence[].id and source_id to sources[].id. Cite the publisher, verification URL and observation date for each material claim.
  5. Check meta.partial and sources[].freshness. SOURCE_UNAVAILABLE, PARTIAL and UNKNOWN must remain explicit in your answer.

Interpretation limits

  • Registration status is scoped to a registry. ACTIVE is not an overall compliance verdict.
  • Empty arrays and null fields are not proof of no sanctions, debts or relationships.
  • last_imported_at is the Latinfo ingestion time; source_updated_at and latest_observation_at describe different source dates.

Discover available source contracts

Authentication required. REST requests use a Latinfo API key. The interactive console builds the authorization header and does not store the key.

Parameters

countryenum<AR | CO | EC | PE | PY>pathrequired

ISO 3166-1 alpha-2 country with an active certified native profile. External source-specific lookup support does not imply universal-profile certification. Countries without an active native profile return 501; malformed identifiers return 400.

Example: AR
taxIdstringpathrequired

Use the local company tax identifier for a country in the country enum. Keep identifiers as strings and preserve leading zeros. Punctuation is accepted.

Example: 30500000127

Request example

curl https://api.latinfo.dev/v1/companies/AR/30500000127 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Responses

200Company profile with source evidence and module coverage

Response headers

X-Data-As-Of

Legacy import-time alias. Prefer the explicit freshness fields in sources[].

X-Latinfo-Imported-At

date-time

X-Source-Updated-At

date-time

X-Latest-Observation-At

date

X-Expected-Update-Frequency

string

DAILY · WEEKLY · MONTHLY · YEARLY · MANUAL · UNKNOWN
X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN
X-Verify-Live

uri

X-Credits-Cost

integer

Content-Type: application/json

Response fields

activities array required

Economic activities with original local classifications and any supported international crosswalk.

Nested fields
activities[].evidence_refs array required
activities[].id string required
activities[].international union required
Nested fields
activities[].international.code string required
activities[].international.description string required
activities[].international.level object required

CLASS · DIVISION · GROUP · SECTION

activities[].international.mapping_method object required

OFFICIAL_CROSSWALK · REVIEWED_CROSSWALK

activities[].international.mapping_relation object required

APPROXIMATE · EXACT · MANY_TO_ONE · ONE_TO_MANY

activities[].international.revision object required

4

activities[].international.system object required

ISIC_REV4

activities[].local object required
Nested fields
activities[].local.code union required
activities[].local.description union required
activities[].local.revision union required
activities[].local.system string required
activities[].role object required

OTHER · PRIMARY · SECONDARY

addresses array required

Addresses reported by the checked public sources, not independently verified operating locations.

Nested fields
addresses[].administrative_area union required
addresses[].country object required

AR · BO · BR · CL · CO · EC · PE · PY

addresses[].evidence_refs array required
addresses[].full_address union required
addresses[].id string required
addresses[].line_1 union required
addresses[].line_2 union required
addresses[].local_subdivision_code union required
addresses[].locality union required
addresses[].postal_code union required
addresses[].raw union required
addresses[].type object required

FACILITY · FISCAL · OPERATING · OTHER · REGISTERED

company object required

Normalized company identity. primary_status is scoped to a registry and is not a compliance verdict.

Nested fields
company.country object required
Nested fields
company.country.code object required

AR · BO · BR · CL · CO · EC · PE · PY

company.country.name string required
company.entity_type object required

GOVERNMENT_ENTITY · LEGAL_ENTITY · ORGANIZATION

company.id string required
company.incorporation_date union required
company.legal_name string required
company.primary_status union required
Nested fields
company.primary_status.code object required

ACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN

company.primary_status.evidence_refs array required
company.primary_status.scope object required

COMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION

company.trade_names array required
coverage object required

Per-module status and sources checked. Distinguishes unsupported, unavailable, partial and no-record results.

Nested fields
coverage.activities object required
Nested fields
coverage.activities.data_as_of union required
coverage.activities.sources_checked array required
coverage.activities.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.addresses object required
Nested fields
coverage.addresses.data_as_of union required
coverage.addresses.sources_checked array required
coverage.addresses.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.customs object required
Nested fields
coverage.customs.data_as_of union required
coverage.customs.sources_checked array required
coverage.customs.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.debts object required
Nested fields
coverage.debts.data_as_of union required
coverage.debts.sources_checked array required
coverage.debts.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.extensions object required
Nested fields
coverage.extensions.data_as_of union required
coverage.extensions.sources_checked array required
coverage.extensions.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.facilities object required
Nested fields
coverage.facilities.data_as_of union required
coverage.facilities.sources_checked array required
coverage.facilities.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.identity object required
Nested fields
coverage.identity.data_as_of union required
coverage.identity.sources_checked array required
coverage.identity.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.public_procurement object required
Nested fields
coverage.public_procurement.data_as_of union required
coverage.public_procurement.sources_checked array required
coverage.public_procurement.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.registrations object required
Nested fields
coverage.registrations.data_as_of union required
coverage.registrations.sources_checked array required
coverage.registrations.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.relationships object required
Nested fields
coverage.relationships.data_as_of union required
coverage.relationships.sources_checked array required
coverage.relationships.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.representatives object required
Nested fields
coverage.representatives.data_as_of union required
coverage.representatives.sources_checked array required
coverage.representatives.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.sanctions object required
Nested fields
coverage.sanctions.data_as_of union required
coverage.sanctions.sources_checked array required
coverage.sanctions.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.statuses object required
Nested fields
coverage.statuses.data_as_of union required
coverage.statuses.sources_checked array required
coverage.statuses.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.supervision object required
Nested fields
coverage.supervision.data_as_of union required
coverage.supervision.sources_checked array required
coverage.supervision.status object required

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

customs object required

Published customs observations and summaries. FOB values are USD; net weights are kilograms.

Nested fields
customs.operations array required
Nested fields
customs.operations[].declaration string required
customs.operations[].description union required
customs.operations[].evidence_refs array required
customs.operations[].fob_usd union required
customs.operations[].hs_code string required
customs.operations[].id string required
customs.operations[].net_weight_kg union required
customs.operations[].operation_date union required
customs.operations[].operation_type object required

EXPORT · IMPORT

customs.operations[].partner_country union required
customs.summary union required
Nested fields
customs.summary.first_operation_date union required
customs.summary.last_operation_date union required
customs.summary.operation_count integer required
customs.summary.total_fob_usd union required
customs.summary.total_net_weight_kg union required
debts array required

Published debt observations. Preserve amount, currency, reporting period and evidence.

Nested fields
debts[].amount union required
Nested fields
debts[].amount.amount string required
debts[].amount.currency string required
debts[].evidence_refs array required
debts[].id string required
debts[].observed_at union required
debts[].status object required

PUBLISHED · SETTLED · UNKNOWN

debts[].type string required
evidence array required

Claim-level evidence. Resolve evidence_refs against these stable IDs; cite publisher and verification URL.

Nested fields
evidence[].claims array required
evidence[].data_as_of union required
evidence[].id string required
evidence[].license union required
evidence[].publisher object required
Nested fields
evidence[].publisher.acronym union required
evidence[].publisher.country string required
evidence[].publisher.local_name string required
evidence[].reporting_basis object required

COMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY

evidence[].retrieved_at string required

^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$

evidence[].source_id string required
evidence[].source_record object required
evidence[].verification_url union required
extensions object required

Additional source-specific data outside the normalized modules; consult its source contract.

facilities array required

Facilities recorded by available official sources.

Nested fields
facilities[].address union required
Nested fields
facilities[].address.administrative_area union required
facilities[].address.country object required

AR · BO · BR · CL · CO · EC · PE · PY

facilities[].address.evidence_refs array required
facilities[].address.full_address union required
facilities[].address.id string required
facilities[].address.line_1 union required
facilities[].address.line_2 union required
facilities[].address.local_subdivision_code union required
facilities[].address.locality union required
facilities[].address.postal_code union required
facilities[].address.raw union required
facilities[].address.type object required

FACILITY · FISCAL · OPERATING · OTHER · REGISTERED

facilities[].evidence_refs array required
facilities[].id string required
facilities[].name union required
facilities[].status union required
facilities[].type string required
identifiers array required

Country-scoped company tax identifiers. Preserve these as strings, including leading zeros.

Nested fields
identifiers[].check_digit union required
identifiers[].country object required

AR · BO · BR · CL · CO · EC · PE · PY

identifiers[].evidence_refs array required
identifiers[].formatted string required
identifiers[].local_name string required
identifiers[].scheme object required

AR_CUIT · BO_NIT · BR_CNPJ · CL_RUT · CO_NIT · EC_RUC · PE_RUC · PY_RUC

identifiers[].type object required

TAX_ID

identifiers[].value string required
meta object required

Request metadata, modules requested and partial-result flag. Legacy credits_charged is always zero; access is free.

Nested fields
meta.credits_charged integer required
meta.generated_at string required

^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$

meta.locale string required
meta.partial boolean required
meta.request_id string required
meta.requested_modules array required
public_procurement object required

Supplier registrations and procurement processes, kept as distinct observations.

Nested fields
public_procurement.processes array required
Nested fields
public_procurement.processes[].amount union required
Nested fields
public_procurement.processes[].amount.amount string required
public_procurement.processes[].amount.currency string required
public_procurement.processes[].date union required
public_procurement.processes[].evidence_refs array required
public_procurement.processes[].id string required
public_procurement.processes[].role object required

BUYER · CONSORTIUM_MEMBER · OTHER · SUPPLIER

public_procurement.processes[].status union required
public_procurement.processes[].title union required
public_procurement.supplier_registrations array required
Nested fields
public_procurement.supplier_registrations[].authority_name string required
public_procurement.supplier_registrations[].evidence_refs array required
public_procurement.supplier_registrations[].id string required
public_procurement.supplier_registrations[].local_name string required
public_procurement.supplier_registrations[].registered_at union required
public_procurement.supplier_registrations[].status object required

ACTIVE · CANCELLED · INACTIVE · SUSPENDED · UNKNOWN

registrations array required

Registrations in the checked official datasets; coverage is not exhaustive.

Nested fields
registrations[].authority object required
Nested fields
registrations[].authority.country object required

AR · BO · BR · CL · CO · EC · PE · PY

registrations[].authority.local_name string required
registrations[].authority.name string required
registrations[].event union required
registrations[].evidence_refs array required
registrations[].id string required
registrations[].is_current union required
registrations[].number union required
registrations[].raw_status union required
registrations[].registered_at union required
registrations[].renewed_at union required
registrations[].status object required

ACTIVE · CANCELLED · INACTIVE · PENDING · SUSPENDED · UNKNOWN

registrations[].type object required

COMMERCIAL_REGISTRATION · OTHER · PUBLIC_PROCUREMENT_SUPPLIER · REGULATORY_REGISTRATION · TAX_REGISTRATION

relationships array required

Relationships disclosed by sources; do not infer undisclosed ownership.

Nested fields
relationships[].effective_from union required
relationships[].effective_to union required
relationships[].evidence_refs array required
relationships[].id string required
relationships[].subject_identifier union required
relationships[].subject_name union required
relationships[].type string required
representatives array required

Published roles and legal representation; this is not a beneficial-ownership determination.

Nested fields
representatives[].effective_from union required
representatives[].effective_to union required
representatives[].evidence_refs array required
representatives[].id string required
representatives[].is_current union required
representatives[].name string required
representatives[].role string required
sanctions array required

Sanction records found in the checked sources. An empty array is not a clearance.

Nested fields
sanctions[].amount union required
Nested fields
sanctions[].amount.amount string required
sanctions[].amount.currency string required
sanctions[].authority_name string required
sanctions[].decision_date union required
sanctions[].decision_reference union required
sanctions[].effective_from union required
sanctions[].effective_to union required
sanctions[].evidence_refs array required
sanctions[].id string required
sanctions[].raw_type union required
sanctions[].status object required

ACTIVE · COMPLETED · EXPIRED · UNKNOWN

sanctions[].title union required
sanctions[].type string required
schema_version object required

Response contract version; use this to detect incompatible schema changes.

1.0

sources array required

Datasets checked and their explicit freshness dates. Import time is not observation time.

Nested fields
sources[].coverage object required
Nested fields
sources[].coverage.from union required
sources[].coverage.to union required
sources[].data_as_of union required
sources[].dataset_name string required
sources[].expected_update_frequency object required

DAILY · MANUAL · MONTHLY · UNKNOWN · WEEKLY · YEARLY

sources[].freshness object required

CURRENT · DELAYED · STALE · UNKNOWN

sources[].id string required
sources[].last_imported_at union required
sources[].latest_observation_at union required
sources[].publisher_name string required
sources[].reporting_basis object required

COMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY

sources[].source_updated_at union required
sources[].verification_url union required
statuses array required

Separate registry observations. Preserve scope, original label and evidence rather than choosing a global verdict.

Nested fields
statuses[].code object required

ACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN

statuses[].effective_from union required
statuses[].effective_to union required
statuses[].evidence_refs array required
statuses[].explanation union required
statuses[].id string required
statuses[].label string required
statuses[].raw object required
Nested fields
statuses[].raw.language string required
statuses[].raw.value string required
statuses[].scope object required

COMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION

supervision array required

Sectoral supervision or registration observations from the checked authorities.

Nested fields
supervision[].authority_name string required
supervision[].evidence_refs array required
supervision[].id string required
supervision[].registration_type string required
supervision[].status union required
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "activities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "international": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "level": {
                    "enum": [
                      "CLASS",
                      "DIVISION",
                      "GROUP",
                      "SECTION"
                    ]
                  },
                  "mapping_method": {
                    "enum": [
                      "OFFICIAL_CROSSWALK",
                      "REVIEWED_CROSSWALK"
                    ]
                  },
                  "mapping_relation": {
                    "enum": [
                      "APPROXIMATE",
                      "EXACT",
                      "MANY_TO_ONE",
                      "ONE_TO_MANY"
                    ]
                  },
                  "revision": {
                    "const": "4"
                  },
                  "system": {
                    "const": "ISIC_REV4"
                  }
                },
                "required": [
                  "code",
                  "description",
                  "level",
                  "mapping_method",
                  "mapping_relation",
                  "revision",
                  "system"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "local": {
            "type": "object",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "revision": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "system": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "description",
              "revision",
              "system"
            ],
            "additionalProperties": false
          },
          "role": {
            "enum": [
              "OTHER",
              "PRIMARY",
              "SECONDARY"
            ]
          }
        },
        "required": [
          "evidence_refs",
          "id",
          "international",
          "local",
          "role"
        ],
        "additionalProperties": false
      },
      "description": "Economic activities with original local classifications and any supported international crosswalk."
    },
    "addresses": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "administrative_area": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "country": {
            "enum": [
              "AR",
              "BO",
              "BR",
              "CL",
              "CO",
              "EC",
              "PE",
              "PY"
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "full_address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "line_1": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "line_2": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "local_subdivision_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "locality": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "postal_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "raw": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "enum": [
              "FACILITY",
              "FISCAL",
              "OPERATING",
              "OTHER",
              "REGISTERED"
            ]
          }
        },
        "required": [
          "administrative_area",
          "country",
          "evidence_refs",
          "full_address",
          "id",
          "line_1",
          "line_2",
          "local_subdivision_code",
          "locality",
          "postal_code",
          "raw",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Addresses reported by the checked public sources, not independently verified operating locations."
    },
    "company": {
      "type": "object",
      "properties": {
        "country": {
          "type": "object",
          "properties": {
            "code": {
              "enum": [
                "AR",
                "BO",
                "BR",
                "CL",
                "CO",
                "EC",
                "PE",
                "PY"
              ]
            },
            "name": {
              "type": "string"
            }
          },
          "required": [
            "code",
            "name"
          ],
          "additionalProperties": false
        },
        "entity_type": {
          "enum": [
            "GOVERNMENT_ENTITY",
            "LEGAL_ENTITY",
            "ORGANIZATION"
          ]
        },
        "id": {
          "type": "string"
        },
        "incorporation_date": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
            },
            {
              "type": "null"
            }
          ]
        },
        "legal_name": {
          "type": "string"
        },
        "primary_status": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "code": {
                  "enum": [
                    "ACTIVE",
                    "CANCELLED",
                    "DISSOLVED",
                    "INACTIVE",
                    "PENDING",
                    "SUSPENDED",
                    "UNKNOWN"
                  ]
                },
                "evidence_refs": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "scope": {
                  "enum": [
                    "COMMERCIAL_REGISTRATION",
                    "FACILITY",
                    "LEGAL_ENTITY",
                    "PROCUREMENT_SUPPLIER_REGISTRATION",
                    "REGULATORY_REGISTRATION",
                    "TAX_REGISTRATION"
                  ]
                }
              },
              "required": [
                "code",
                "evidence_refs",
                "scope"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "trade_names": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "country",
        "entity_type",
        "id",
        "incorporation_date",
        "legal_name",
        "primary_status",
        "trade_names"
      ],
      "additionalProperties": false,
      "description": "Normalized company identity. primary_status is scoped to a registry and is not a compliance verdict."
    },
    "coverage": {
      "type": "object",
      "properties": {
        "activities": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "addresses": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "customs": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "debts": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "extensions": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "facilities": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "identity": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "public_procurement": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "registrations": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "relationships": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "representatives": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "sanctions": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "statuses": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "supervision": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "activities",
        "addresses",
        "customs",
        "debts",
        "extensions",
        "facilities",
        "identity",
        "public_procurement",
        "registrations",
        "relationships",
        "representatives",
        "sanctions",
        "statuses",
        "supervision"
      ],
      "additionalProperties": false,
      "description": "Per-module status and sources checked. Distinguishes unsupported, unavailable, partial and no-record results."
    },
    "customs": {
      "type": "object",
      "properties": {
        "operations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "declaration": {
                "type": "string"
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "evidence_refs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "fob_usd": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "hs_code": {
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "net_weight_kg": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "operation_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "operation_type": {
                "enum": [
                  "EXPORT",
                  "IMPORT"
                ]
              },
              "partner_country": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "declaration",
              "description",
              "evidence_refs",
              "fob_usd",
              "hs_code",
              "id",
              "net_weight_kg",
              "operation_date",
              "operation_type",
              "partner_country"
            ],
            "additionalProperties": false
          }
        },
        "summary": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "first_operation_date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "last_operation_date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "operation_count": {
                  "type": "integer",
                  "minimum": 0
                },
                "total_fob_usd": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "total_net_weight_kg": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "first_operation_date",
                "last_operation_date",
                "operation_count",
                "total_fob_usd",
                "total_net_weight_kg"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "operations",
        "summary"
      ],
      "additionalProperties": false,
      "description": "Published customs observations and summaries. FOB values are USD; net weights are kilograms."
    },
    "debts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "amount": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "string"
                  },
                  "currency": {
                    "type": "string"
                  }
                },
                "required": [
                  "amount",
                  "currency"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "observed_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "enum": [
              "PUBLISHED",
              "SETTLED",
              "UNKNOWN"
            ]
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "amount",
          "evidence_refs",
          "id",
          "observed_at",
          "status",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Published debt observations. Preserve amount, currency, reporting period and evidence."
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "claims": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^[^\\[\\]]+quot;
            }
          },
          "data_as_of": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "license": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "publisher": {
            "type": "object",
            "properties": {
              "acronym": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "country": {
                "type": "string"
              },
              "local_name": {
                "type": "string"
              }
            },
            "required": [
              "acronym",
              "country",
              "local_name"
            ],
            "additionalProperties": false
          },
          "reporting_basis": {
            "enum": [
              "COMPANY_DECLARED_TO_AUTHORITY",
              "LATINFO_DERIVED",
              "OFFICIAL_PUBLICATION",
              "OFFICIAL_REGISTRY",
              "THIRD_PARTY_DECLARED_TO_AUTHORITY"
            ]
          },
          "retrieved_at": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Zquot;
          },
          "source_id": {
            "type": "string"
          },
          "source_record": {
            "type": "object"
          },
          "verification_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "claims",
          "data_as_of",
          "id",
          "license",
          "publisher",
          "reporting_basis",
          "retrieved_at",
          "source_id",
          "source_record",
          "verification_url"
        ],
        "additionalProperties": false
      },
      "description": "Claim-level evidence. Resolve evidence_refs against these stable IDs; cite publisher and verification URL."
    },
    "extensions": {
      "type": "object",
      "description": "Additional source-specific data outside the normalized modules; consult its source contract."
    },
    "facilities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "administrative_area": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "country": {
                    "enum": [
                      "AR",
                      "BO",
                      "BR",
                      "CL",
                      "CO",
                      "EC",
                      "PE",
                      "PY"
                    ]
                  },
                  "evidence_refs": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "full_address": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "id": {
                    "type": "string"
                  },
                  "line_1": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "line_2": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "local_subdivision_code": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "locality": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "postal_code": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "raw": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "type": {
                    "enum": [
                      "FACILITY",
                      "FISCAL",
                      "OPERATING",
                      "OTHER",
                      "REGISTERED"
                    ]
                  }
                },
                "required": [
                  "administrative_area",
                  "country",
                  "evidence_refs",
                  "full_address",
                  "id",
                  "line_1",
                  "line_2",
                  "local_subdivision_code",
                  "locality",
                  "postal_code",
                  "raw",
                  "type"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "address",
          "evidence_refs",
          "id",
          "name",
          "status",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Facilities recorded by available official sources."
    },
    "identifiers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "check_digit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "country": {
            "enum": [
              "AR",
              "BO",
              "BR",
              "CL",
              "CO",
              "EC",
              "PE",
              "PY"
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "formatted": {
            "type": "string"
          },
          "local_name": {
            "type": "string"
          },
          "scheme": {
            "enum": [
              "AR_CUIT",
              "BO_NIT",
              "BR_CNPJ",
              "CL_RUT",
              "CO_NIT",
              "EC_RUC",
              "PE_RUC",
              "PY_RUC"
            ]
          },
          "type": {
            "const": "TAX_ID"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "check_digit",
          "country",
          "evidence_refs",
          "formatted",
          "local_name",
          "scheme",
          "type",
          "value"
        ],
        "additionalProperties": false
      },
      "description": "Country-scoped company tax identifiers. Preserve these as strings, including leading zeros."
    },
    "meta": {
      "type": "object",
      "properties": {
        "credits_charged": {
          "type": "integer",
          "minimum": 0
        },
        "generated_at": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Zquot;
        },
        "locale": {
          "type": "string"
        },
        "partial": {
          "type": "boolean"
        },
        "request_id": {
          "type": "string"
        },
        "requested_modules": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "credits_charged",
        "generated_at",
        "locale",
        "partial",
        "request_id",
        "requested_modules"
      ],
      "additionalProperties": false,
      "description": "Request metadata, modules requested and partial-result flag. Legacy credits_charged is always zero; access is free."
    },
    "public_procurement": {
      "type": "object",
      "properties": {
        "processes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "amount": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "amount": {
                        "type": "string"
                      },
                      "currency": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "amount",
                      "currency"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "evidence_refs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "id": {
                "type": "string"
              },
              "role": {
                "enum": [
                  "BUYER",
                  "CONSORTIUM_MEMBER",
                  "OTHER",
                  "SUPPLIER"
                ]
              },
              "status": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "title": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "amount",
              "date",
              "evidence_refs",
              "id",
              "role",
              "status",
              "title"
            ],
            "additionalProperties": false
          }
        },
        "supplier_registrations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "authority_name": {
                "type": "string"
              },
              "evidence_refs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "id": {
                "type": "string"
              },
              "local_name": {
                "type": "string"
              },
              "registered_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "enum": [
                  "ACTIVE",
                  "CANCELLED",
                  "INACTIVE",
                  "SUSPENDED",
                  "UNKNOWN"
                ]
              }
            },
            "required": [
              "authority_name",
              "evidence_refs",
              "id",
              "local_name",
              "registered_at",
              "status"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "processes",
        "supplier_registrations"
      ],
      "additionalProperties": false,
      "description": "Supplier registrations and procurement processes, kept as distinct observations."
    },
    "registrations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "authority": {
            "type": "object",
            "properties": {
              "country": {
                "enum": [
                  "AR",
                  "BO",
                  "BR",
                  "CL",
                  "CO",
                  "EC",
                  "PE",
                  "PY"
                ]
              },
              "local_name": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "country",
              "local_name",
              "name"
            ],
            "additionalProperties": false
          },
          "event": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "is_current": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "number": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "raw_status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "registered_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "renewed_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "enum": [
              "ACTIVE",
              "CANCELLED",
              "INACTIVE",
              "PENDING",
              "SUSPENDED",
              "UNKNOWN"
            ]
          },
          "type": {
            "enum": [
              "COMMERCIAL_REGISTRATION",
              "OTHER",
              "PUBLIC_PROCUREMENT_SUPPLIER",
              "REGULATORY_REGISTRATION",
              "TAX_REGISTRATION"
            ]
          }
        },
        "required": [
          "authority",
          "event",
          "evidence_refs",
          "id",
          "is_current",
          "number",
          "raw_status",
          "registered_at",
          "renewed_at",
          "status",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Registrations in the checked official datasets; coverage is not exhaustive."
    },
    "relationships": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "effective_from": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_to": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "subject_identifier": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "subject_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "effective_from",
          "effective_to",
          "evidence_refs",
          "id",
          "subject_identifier",
          "subject_name",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Relationships disclosed by sources; do not infer undisclosed ownership."
    },
    "representatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "effective_from": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_to": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "is_current": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "type": "string"
          },
          "role": {
            "type": "string"
          }
        },
        "required": [
          "effective_from",
          "effective_to",
          "evidence_refs",
          "id",
          "is_current",
          "name",
          "role"
        ],
        "additionalProperties": false
      },
      "description": "Published roles and legal representation; this is not a beneficial-ownership determination."
    },
    "sanctions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "amount": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "string"
                  },
                  "currency": {
                    "type": "string"
                  }
                },
                "required": [
                  "amount",
                  "currency"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "authority_name": {
            "type": "string"
          },
          "decision_date": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "decision_reference": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_from": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_to": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "raw_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "enum": [
              "ACTIVE",
              "COMPLETED",
              "EXPIRED",
              "UNKNOWN"
            ]
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "amount",
          "authority_name",
          "decision_date",
          "decision_reference",
          "effective_from",
          "effective_to",
          "evidence_refs",
          "id",
          "raw_type",
          "status",
          "title",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Sanction records found in the checked sources. An empty array is not a clearance."
    },
    "schema_version": {
      "const": "1.0",
      "description": "Response contract version; use this to detect incompatible schema changes."
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "coverage": {
            "type": "object",
            "properties": {
              "from": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "to": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "from",
              "to"
            ],
            "additionalProperties": false
          },
          "data_as_of": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "dataset_name": {
            "type": "string"
          },
          "expected_update_frequency": {
            "enum": [
              "DAILY",
              "MANUAL",
              "MONTHLY",
              "UNKNOWN",
              "WEEKLY",
              "YEARLY"
            ]
          },
          "freshness": {
            "enum": [
              "CURRENT",
              "DELAYED",
              "STALE",
              "UNKNOWN"
            ]
          },
          "id": {
            "type": "string"
          },
          "last_imported_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Zquot;
              },
              {
                "type": "null"
              }
            ]
          },
          "latest_observation_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "publisher_name": {
            "type": "string"
          },
          "reporting_basis": {
            "enum": [
              "COMPANY_DECLARED_TO_AUTHORITY",
              "LATINFO_DERIVED",
              "OFFICIAL_PUBLICATION",
              "OFFICIAL_REGISTRY",
              "THIRD_PARTY_DECLARED_TO_AUTHORITY"
            ]
          },
          "source_updated_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Zquot;
              },
              {
                "type": "null"
              }
            ]
          },
          "verification_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "coverage",
          "data_as_of",
          "dataset_name",
          "expected_update_frequency",
          "freshness",
          "id",
          "last_imported_at",
          "latest_observation_at",
          "publisher_name",
          "reporting_basis",
          "source_updated_at",
          "verification_url"
        ],
        "additionalProperties": false
      },
      "description": "Datasets checked and their explicit freshness dates. Import time is not observation time."
    },
    "statuses": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "enum": [
              "ACTIVE",
              "CANCELLED",
              "DISSOLVED",
              "INACTIVE",
              "PENDING",
              "SUSPENDED",
              "UNKNOWN"
            ]
          },
          "effective_from": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_to": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "explanation": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "raw": {
            "type": "object",
            "properties": {
              "language": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "required": [
              "language",
              "value"
            ],
            "additionalProperties": false
          },
          "scope": {
            "enum": [
              "COMMERCIAL_REGISTRATION",
              "FACILITY",
              "LEGAL_ENTITY",
              "PROCUREMENT_SUPPLIER_REGISTRATION",
              "REGULATORY_REGISTRATION",
              "TAX_REGISTRATION"
            ]
          }
        },
        "required": [
          "code",
          "effective_from",
          "effective_to",
          "evidence_refs",
          "explanation",
          "id",
          "label",
          "raw",
          "scope"
        ],
        "additionalProperties": false
      },
      "description": "Separate registry observations. Preserve scope, original label and evidence rather than choosing a global verdict."
    },
    "supervision": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "authority_name": {
            "type": "string"
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "registration_type": {
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "authority_name",
          "evidence_refs",
          "id",
          "registration_type",
          "status"
        ],
        "additionalProperties": false
      },
      "description": "Sectoral supervision or registration observations from the checked authorities."
    }
  },
  "required": [
    "activities",
    "addresses",
    "company",
    "coverage",
    "customs",
    "debts",
    "evidence",
    "extensions",
    "facilities",
    "identifiers",
    "meta",
    "public_procurement",
    "registrations",
    "relationships",
    "representatives",
    "sanctions",
    "schema_version",
    "sources",
    "statuses",
    "supervision"
  ],
  "additionalProperties": false
}
400Invalid country-scoped tax identifier
No response body documented.
401Missing or invalid API key
No response body documented.
404Company not found
No response body documented.
429Rate limit exceeded
No response body documented.
501Country not yet promoted to the universal contract
No response body documented.
503Current semantic readiness receipt is unavailable or stale
No response body documented.
Example JSON

Illustrative schema example. This is not a live response.

{
  "activities": [
    {
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "international": {
        "code": null,
        "description": null,
        "level": null,
        "mapping_method": null,
        "mapping_relation": null,
        "revision": null,
        "system": null
      },
      "local": {
        "code": null,
        "description": null,
        "revision": null,
        "system": "string"
      },
      "role": "OTHER"
    }
  ],
  "addresses": [
    {
      "administrative_area": "string",
      "country": "AR",
      "evidence_refs": [
        "string"
      ],
      "full_address": "string",
      "id": "string",
      "line_1": "string",
      "line_2": "string",
      "local_subdivision_code": "string",
      "locality": "string",
      "postal_code": "string",
      "raw": "string",
      "type": "FACILITY"
    }
  ],
  "company": {
    "country": {
      "code": "AR",
      "name": "string"
    },
    "entity_type": "GOVERNMENT_ENTITY",
    "id": "string",
    "incorporation_date": "string",
    "legal_name": "string",
    "primary_status": {
      "code": "ACTIVE",
      "evidence_refs": [
        null
      ],
      "scope": "COMMERCIAL_REGISTRATION"
    },
    "trade_names": [
      "string"
    ]
  },
  "coverage": {
    "activities": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "addresses": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "customs": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "debts": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "extensions": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "facilities": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "identity": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "public_procurement": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "registrations": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "relationships": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "representatives": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "sanctions": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "statuses": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "supervision": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    }
  },
  "customs": {
    "operations": [
      {
        "declaration": "string",
        "description": null,
        "evidence_refs": [
          null
        ],
        "fob_usd": null,
        "hs_code": "string",
        "id": "string",
        "net_weight_kg": null,
        "operation_date": null,
        "operation_type": "EXPORT",
        "partner_country": null
      }
    ],
    "summary": {
      "first_operation_date": null,
      "last_operation_date": null,
      "operation_count": 0,
      "total_fob_usd": null,
      "total_net_weight_kg": null
    }
  },
  "debts": [
    {
      "amount": {
        "amount": null,
        "currency": null
      },
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "observed_at": "string",
      "status": "PUBLISHED",
      "type": "string"
    }
  ],
  "evidence": [
    {
      "claims": [
        "string"
      ],
      "data_as_of": "string",
      "id": "string",
      "license": "string",
      "publisher": {
        "acronym": null,
        "country": "string",
        "local_name": "string"
      },
      "reporting_basis": "COMPANY_DECLARED_TO_AUTHORITY",
      "retrieved_at": "string",
      "source_id": "string",
      "source_record": {},
      "verification_url": "string"
    }
  ],
  "extensions": {},
  "facilities": [
    {
      "address": {
        "administrative_area": null,
        "country": null,
        "evidence_refs": null,
        "full_address": null,
        "id": null,
        "line_1": null,
        "line_2": null,
        "local_subdivision_code": null,
        "locality": null,
        "postal_code": null,
        "raw": null,
        "type": null
      },
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "name": "string",
      "status": "string",
      "type": "string"
    }
  ],
  "identifiers": [
    {
      "check_digit": "string",
      "country": "AR",
      "evidence_refs": [
        "string"
      ],
      "formatted": "string",
      "local_name": "string",
      "scheme": "AR_CUIT",
      "type": "TAX_ID",
      "value": "string"
    }
  ],
  "meta": {
    "credits_charged": 0,
    "generated_at": "string",
    "locale": "string",
    "partial": true,
    "request_id": "string",
    "requested_modules": [
      "string"
    ]
  },
  "public_procurement": {
    "processes": [
      {
        "amount": null,
        "date": null,
        "evidence_refs": [
          null
        ],
        "id": "string",
        "role": "BUYER",
        "status": null,
        "title": null
      }
    ],
    "supplier_registrations": [
      {
        "authority_name": "string",
        "evidence_refs": [
          null
        ],
        "id": "string",
        "local_name": "string",
        "registered_at": null,
        "status": "ACTIVE"
      }
    ]
  },
  "registrations": [
    {
      "authority": {
        "country": "AR",
        "local_name": "string",
        "name": "string"
      },
      "event": "string",
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "is_current": true,
      "number": "string",
      "raw_status": "string",
      "registered_at": "string",
      "renewed_at": "string",
      "status": "ACTIVE",
      "type": "COMMERCIAL_REGISTRATION"
    }
  ],
  "relationships": [
    {
      "effective_from": "string",
      "effective_to": "string",
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "subject_identifier": "string",
      "subject_name": "string",
      "type": "string"
    }
  ],
  "representatives": [
    {
      "effective_from": "string",
      "effective_to": "string",
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "is_current": true,
      "name": "string",
      "role": "string"
    }
  ],
  "sanctions": [
    {
      "amount": {
        "amount": null,
        "currency": null
      },
      "authority_name": "string",
      "decision_date": "string",
      "decision_reference": "string",
      "effective_from": "string",
      "effective_to": "string",
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "raw_type": "string",
      "status": "ACTIVE",
      "title": "string",
      "type": "string"
    }
  ],
  "schema_version": "1.0",
  "sources": [
    {
      "coverage": {
        "from": null,
        "to": null
      },
      "data_as_of": "string",
      "dataset_name": "string",
      "expected_update_frequency": "DAILY",
      "freshness": "CURRENT",
      "id": "string",
      "last_imported_at": "string",
      "latest_observation_at": "string",
      "publisher_name": "string",
      "reporting_basis": "COMPANY_DECLARED_TO_AUTHORITY",
      "source_updated_at": "string",
      "verification_url": "string"
    }
  ]
}

Provenance and limitations

Coverage varies by country and public source. A missing field is not evidence that the underlying fact does not exist. Public registries may be delayed or contain source errors; inspect the returned evidence and source date before relying on a result.