Universal LATAM company profile
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
- With only a name, search the appropriate country registry and confirm the candidate. A name match is not a unique identity.
- Send country and taxId as strings. Keep leading zeros. Use the company tax identifier, never a DNI or a personal identifier.
- 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.
- Follow evidence_refs to evidence[].id and source_id to sources[].id. Cite the publisher, verification URL and observation date for each material claim.
- 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.
Parameters
countryenum<AR | CO | EC | PE | PY>pathrequiredISO 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
taxIdstringpathrequiredUse 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-OfLegacy import-time alias. Prefer the explicit freshness fields in sources[].
X-Latinfo-Imported-Atdate-time
X-Source-Updated-Atdate-time
X-Latest-Observation-Atdate
X-Expected-Update-Frequencystring
DAILY · WEEKLY · MONTHLY · YEARLY · MANUAL · UNKNOWNX-Freshness-Statusstring
CURRENT · DELAYED · STALE · UNKNOWNX-Verify-Liveuri
X-Credits-Costinteger
application/jsonResponse fields
activities array requiredEconomic activities with original local classifications and any supported international crosswalk.
Nested fields
activities[].evidence_refs array requiredactivities[].id string requiredactivities[].international union requiredNested fields
activities[].international.code string requiredactivities[].international.description string requiredactivities[].international.level object requiredCLASS · DIVISION · GROUP · SECTION
activities[].international.mapping_method object requiredOFFICIAL_CROSSWALK · REVIEWED_CROSSWALK
activities[].international.mapping_relation object requiredAPPROXIMATE · EXACT · MANY_TO_ONE · ONE_TO_MANY
activities[].international.revision object required4
activities[].international.system object requiredISIC_REV4
activities[].local object requiredNested fields
activities[].local.code union requiredactivities[].local.description union requiredactivities[].local.revision union requiredactivities[].local.system string requiredactivities[].role object requiredOTHER · PRIMARY · SECONDARY
addresses array requiredAddresses reported by the checked public sources, not independently verified operating locations.
Nested fields
addresses[].administrative_area union requiredaddresses[].country object requiredAR · BO · BR · CL · CO · EC · PE · PY
addresses[].evidence_refs array requiredaddresses[].full_address union requiredaddresses[].id string requiredaddresses[].line_1 union requiredaddresses[].line_2 union requiredaddresses[].local_subdivision_code union requiredaddresses[].locality union requiredaddresses[].postal_code union requiredaddresses[].raw union requiredaddresses[].type object requiredFACILITY · FISCAL · OPERATING · OTHER · REGISTERED
company object requiredNormalized company identity. primary_status is scoped to a registry and is not a compliance verdict.
Nested fields
company.country object requiredNested fields
company.country.code object requiredAR · BO · BR · CL · CO · EC · PE · PY
company.country.name string requiredcompany.entity_type object requiredGOVERNMENT_ENTITY · LEGAL_ENTITY · ORGANIZATION
company.id string requiredcompany.incorporation_date union requiredcompany.legal_name string requiredcompany.primary_status union requiredNested fields
company.primary_status.code object requiredACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
company.primary_status.evidence_refs array requiredcompany.primary_status.scope object requiredCOMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION
company.trade_names array requiredcoverage object requiredPer-module status and sources checked. Distinguishes unsupported, unavailable, partial and no-record results.
Nested fields
coverage.activities object requiredNested fields
coverage.activities.data_as_of union requiredcoverage.activities.sources_checked array requiredcoverage.activities.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.addresses object requiredNested fields
coverage.addresses.data_as_of union requiredcoverage.addresses.sources_checked array requiredcoverage.addresses.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.customs object requiredNested fields
coverage.customs.data_as_of union requiredcoverage.customs.sources_checked array requiredcoverage.customs.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.debts object requiredNested fields
coverage.debts.data_as_of union requiredcoverage.debts.sources_checked array requiredcoverage.debts.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.extensions object requiredNested fields
coverage.extensions.data_as_of union requiredcoverage.extensions.sources_checked array requiredcoverage.extensions.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.facilities object requiredNested fields
coverage.facilities.data_as_of union requiredcoverage.facilities.sources_checked array requiredcoverage.facilities.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.identity object requiredNested fields
coverage.identity.data_as_of union requiredcoverage.identity.sources_checked array requiredcoverage.identity.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.public_procurement object requiredNested fields
coverage.public_procurement.data_as_of union requiredcoverage.public_procurement.sources_checked array requiredcoverage.public_procurement.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.registrations object requiredNested fields
coverage.registrations.data_as_of union requiredcoverage.registrations.sources_checked array requiredcoverage.registrations.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.relationships object requiredNested fields
coverage.relationships.data_as_of union requiredcoverage.relationships.sources_checked array requiredcoverage.relationships.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.representatives object requiredNested fields
coverage.representatives.data_as_of union requiredcoverage.representatives.sources_checked array requiredcoverage.representatives.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.sanctions object requiredNested fields
coverage.sanctions.data_as_of union requiredcoverage.sanctions.sources_checked array requiredcoverage.sanctions.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.statuses object requiredNested fields
coverage.statuses.data_as_of union requiredcoverage.statuses.sources_checked array requiredcoverage.statuses.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.supervision object requiredNested fields
coverage.supervision.data_as_of union requiredcoverage.supervision.sources_checked array requiredcoverage.supervision.status object requiredAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
customs object requiredPublished customs observations and summaries. FOB values are USD; net weights are kilograms.
Nested fields
customs.operations array requiredNested fields
customs.operations[].declaration string requiredcustoms.operations[].description union requiredcustoms.operations[].evidence_refs array requiredcustoms.operations[].fob_usd union requiredcustoms.operations[].hs_code string requiredcustoms.operations[].id string requiredcustoms.operations[].net_weight_kg union requiredcustoms.operations[].operation_date union requiredcustoms.operations[].operation_type object requiredEXPORT · IMPORT
customs.operations[].partner_country union requiredcustoms.summary union requiredNested fields
customs.summary.first_operation_date union requiredcustoms.summary.last_operation_date union requiredcustoms.summary.operation_count integer requiredcustoms.summary.total_fob_usd union requiredcustoms.summary.total_net_weight_kg union requireddebts array requiredPublished debt observations. Preserve amount, currency, reporting period and evidence.
Nested fields
debts[].amount union requiredNested fields
debts[].amount.amount string requireddebts[].amount.currency string requireddebts[].evidence_refs array requireddebts[].id string requireddebts[].observed_at union requireddebts[].status object requiredPUBLISHED · SETTLED · UNKNOWN
debts[].type string requiredevidence array requiredClaim-level evidence. Resolve evidence_refs against these stable IDs; cite publisher and verification URL.
Nested fields
evidence[].claims array requiredevidence[].data_as_of union requiredevidence[].id string requiredevidence[].license union requiredevidence[].publisher object requiredNested fields
evidence[].publisher.acronym union requiredevidence[].publisher.country string requiredevidence[].publisher.local_name string requiredevidence[].reporting_basis object requiredCOMPANY_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 requiredevidence[].source_record object requiredevidence[].verification_url union requiredextensions object requiredAdditional source-specific data outside the normalized modules; consult its source contract.
facilities array requiredFacilities recorded by available official sources.
Nested fields
facilities[].address union requiredNested fields
facilities[].address.administrative_area union requiredfacilities[].address.country object requiredAR · BO · BR · CL · CO · EC · PE · PY
facilities[].address.evidence_refs array requiredfacilities[].address.full_address union requiredfacilities[].address.id string requiredfacilities[].address.line_1 union requiredfacilities[].address.line_2 union requiredfacilities[].address.local_subdivision_code union requiredfacilities[].address.locality union requiredfacilities[].address.postal_code union requiredfacilities[].address.raw union requiredfacilities[].address.type object requiredFACILITY · FISCAL · OPERATING · OTHER · REGISTERED
facilities[].evidence_refs array requiredfacilities[].id string requiredfacilities[].name union requiredfacilities[].status union requiredfacilities[].type string requiredidentifiers array requiredCountry-scoped company tax identifiers. Preserve these as strings, including leading zeros.
Nested fields
identifiers[].check_digit union requiredidentifiers[].country object requiredAR · BO · BR · CL · CO · EC · PE · PY
identifiers[].evidence_refs array requiredidentifiers[].formatted string requiredidentifiers[].local_name string requiredidentifiers[].scheme object requiredAR_CUIT · BO_NIT · BR_CNPJ · CL_RUT · CO_NIT · EC_RUC · PE_RUC · PY_RUC
identifiers[].type object requiredTAX_ID
identifiers[].value string requiredmeta object requiredRequest metadata, modules requested and partial-result flag. Legacy credits_charged is always zero; access is free.
Nested fields
meta.credits_charged integer requiredmeta.generated_at string required^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$
meta.locale string requiredmeta.partial boolean requiredmeta.request_id string requiredmeta.requested_modules array requiredpublic_procurement object requiredSupplier registrations and procurement processes, kept as distinct observations.
Nested fields
public_procurement.processes array requiredNested fields
public_procurement.processes[].amount union requiredNested fields
public_procurement.processes[].amount.amount string requiredpublic_procurement.processes[].amount.currency string requiredpublic_procurement.processes[].date union requiredpublic_procurement.processes[].evidence_refs array requiredpublic_procurement.processes[].id string requiredpublic_procurement.processes[].role object requiredBUYER · CONSORTIUM_MEMBER · OTHER · SUPPLIER
public_procurement.processes[].status union requiredpublic_procurement.processes[].title union requiredpublic_procurement.supplier_registrations array requiredNested fields
public_procurement.supplier_registrations[].authority_name string requiredpublic_procurement.supplier_registrations[].evidence_refs array requiredpublic_procurement.supplier_registrations[].id string requiredpublic_procurement.supplier_registrations[].local_name string requiredpublic_procurement.supplier_registrations[].registered_at union requiredpublic_procurement.supplier_registrations[].status object requiredACTIVE · CANCELLED · INACTIVE · SUSPENDED · UNKNOWN
registrations array requiredRegistrations in the checked official datasets; coverage is not exhaustive.
Nested fields
registrations[].authority object requiredNested fields
registrations[].authority.country object requiredAR · BO · BR · CL · CO · EC · PE · PY
registrations[].authority.local_name string requiredregistrations[].authority.name string requiredregistrations[].event union requiredregistrations[].evidence_refs array requiredregistrations[].id string requiredregistrations[].is_current union requiredregistrations[].number union requiredregistrations[].raw_status union requiredregistrations[].registered_at union requiredregistrations[].renewed_at union requiredregistrations[].status object requiredACTIVE · CANCELLED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
registrations[].type object requiredCOMMERCIAL_REGISTRATION · OTHER · PUBLIC_PROCUREMENT_SUPPLIER · REGULATORY_REGISTRATION · TAX_REGISTRATION
relationships array requiredRelationships disclosed by sources; do not infer undisclosed ownership.
Nested fields
relationships[].effective_from union requiredrelationships[].effective_to union requiredrelationships[].evidence_refs array requiredrelationships[].id string requiredrelationships[].subject_identifier union requiredrelationships[].subject_name union requiredrelationships[].type string requiredrepresentatives array requiredPublished roles and legal representation; this is not a beneficial-ownership determination.
Nested fields
representatives[].effective_from union requiredrepresentatives[].effective_to union requiredrepresentatives[].evidence_refs array requiredrepresentatives[].id string requiredrepresentatives[].is_current union requiredrepresentatives[].name string requiredrepresentatives[].role string requiredsanctions array requiredSanction records found in the checked sources. An empty array is not a clearance.
Nested fields
sanctions[].amount union requiredNested fields
sanctions[].amount.amount string requiredsanctions[].amount.currency string requiredsanctions[].authority_name string requiredsanctions[].decision_date union requiredsanctions[].decision_reference union requiredsanctions[].effective_from union requiredsanctions[].effective_to union requiredsanctions[].evidence_refs array requiredsanctions[].id string requiredsanctions[].raw_type union requiredsanctions[].status object requiredACTIVE · COMPLETED · EXPIRED · UNKNOWN
sanctions[].title union requiredsanctions[].type string requiredschema_version object requiredResponse contract version; use this to detect incompatible schema changes.
1.0
sources array requiredDatasets checked and their explicit freshness dates. Import time is not observation time.
Nested fields
sources[].coverage object requiredNested fields
sources[].coverage.from union requiredsources[].coverage.to union requiredsources[].data_as_of union requiredsources[].dataset_name string requiredsources[].expected_update_frequency object requiredDAILY · MANUAL · MONTHLY · UNKNOWN · WEEKLY · YEARLY
sources[].freshness object requiredCURRENT · DELAYED · STALE · UNKNOWN
sources[].id string requiredsources[].last_imported_at union requiredsources[].latest_observation_at union requiredsources[].publisher_name string requiredsources[].reporting_basis object requiredCOMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY
sources[].source_updated_at union requiredsources[].verification_url union requiredstatuses array requiredSeparate registry observations. Preserve scope, original label and evidence rather than choosing a global verdict.
Nested fields
statuses[].code object requiredACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
statuses[].effective_from union requiredstatuses[].effective_to union requiredstatuses[].evidence_refs array requiredstatuses[].explanation union requiredstatuses[].id string requiredstatuses[].label string requiredstatuses[].raw object requiredNested fields
statuses[].raw.language string requiredstatuses[].raw.value string requiredstatuses[].scope object requiredCOMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION
supervision array requiredSectoral supervision or registration observations from the checked authorities.
Nested fields
supervision[].authority_name string requiredsupervision[].evidence_refs array requiredsupervision[].id string requiredsupervision[].registration_type string requiredsupervision[].status union requiredResponse 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
401Missing or invalid API key
404Company not found
429Rate limit exceeded
501Country not yet promoted to the universal contract
503Current semantic readiness receipt is unavailable or stale
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.