Pangkalahatang profile ng kumpanya sa LATAM
https://api.latinfo.dev/v1/companies/{country}/{taxId}
Gamitin ang universal profile para lamang sa mga bansang nasa enum ng country. Para sa ibang nailathalang bansa, pumili ng source lookup sa /catalog. Hindi awtomatikong may sertipikadong universal profile ang bansang may nailathalang source.
Daloy ng integrasyon
- Kung pangalan lang ang mayroon, maghanap sa registry ng bansa at kumpirmahin ang kumpanya. Hindi natatanging pagkakakilanlan ang magkaparehong pangalan.
- Ipadala ang country at taxId bilang mga string. Panatilihin ang mga zero sa unahan. Gamitin ang tax identifier ng kumpanya, hindi DNI o personal identifier.
- Basahin ang coverage ng bawat module bago bigyang-kahulugan ang mga array. Ang NO_RECORDS ay walang tala sa mga source na sinuri; ang NOT_SUPPORTED ay module na walang saklaw.
- Itugma ang evidence_refs sa evidence[].id at source_id sa sources[].id. Banggitin ang publisher, verification URL at petsa ng obserbasyon sa bawat mahalagang pahayag.
- Suriin ang meta.partial at sources[].freshness. Ilahad nang malinaw ang SOURCE_UNAVAILABLE, PARTIAL at UNKNOWN sa sagot.
Mga limitasyon sa interpretasyon
- Tumutukoy sa isang registry ang registration status. Hindi pangkalahatang hatol sa compliance ang ACTIVE.
- Hindi patunay ng kawalan ng sanction, utang o relasyon ang mga empty array at null field.
- Ang last_imported_at ay oras ng ingestion sa Latinfo; magkaibang petsa ng source ang source_updated_at at latest_observation_at.
Mga parameter
countryenum<AR | CO | EC | PE | PY>PathkailanganISO 3166-1 alpha-2 na bansa na may aktibong sertipikadong native profile. Ang external lookup para sa isang source ay hindi sertipikasyon ng universal profile. Nagbabalik ng 501 ang mga bansang walang aktibong native profile; nagbabalik ng 400 ang maling identifier.
Example: AR
taxIdstringPathkailanganGamitin ang lokal na tax identifier ng kumpanya para sa bansang nasa country enum. Panatilihing string ang mga identifier at ingatan ang mga unang zero. Tinatanggap ang bantas.
Example: 30500000127
Halimbawa ng request
curl https://api.latinfo.dev/v1/companies/AR/30500000127 \
-H "Authorization: Bearer $LATINFO_API_KEY"
Mga tugon
200Profile ng kumpanya na may ebidensiya ng pinagmulan at saklaw ng mga module
Mga header ng tugon
X-Data-As-OfDating alias ng oras ng import. Gamitin ang mga tahasang freshness field sa 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/jsonMga field ng tugon
activities array kailanganMga gawaing pang-ekonomiya na may orihinal na lokal na classification at suportadong international crosswalk.
Mga nested field
activities[].evidence_refs array kailanganactivities[].id string kailanganactivities[].international union kailanganMga nested field
activities[].international.code string kailanganactivities[].international.description string kailanganactivities[].international.level object kailanganCLASS · DIVISION · GROUP · SECTION
activities[].international.mapping_method object kailanganOFFICIAL_CROSSWALK · REVIEWED_CROSSWALK
activities[].international.mapping_relation object kailanganAPPROXIMATE · EXACT · MANY_TO_ONE · ONE_TO_MANY
activities[].international.revision object kailangan4
activities[].international.system object kailanganISIC_REV4
activities[].local object kailanganMga nested field
activities[].local.code union kailanganactivities[].local.description union kailanganactivities[].local.revision union kailanganactivities[].local.system string kailanganactivities[].role object kailanganOTHER · PRIMARY · SECONDARY
addresses array kailanganMga address mula sa sinuring pampublikong pinagmulan; hindi mga lokasyon ng operasyon na independiyenteng napatunayan.
Mga nested field
addresses[].administrative_area union kailanganaddresses[].country object kailanganAR · BO · BR · CL · CO · EC · PE · PY
addresses[].evidence_refs array kailanganaddresses[].full_address union kailanganaddresses[].id string kailanganaddresses[].line_1 union kailanganaddresses[].line_2 union kailanganaddresses[].local_subdivision_code union kailanganaddresses[].locality union kailanganaddresses[].postal_code union kailanganaddresses[].raw union kailanganaddresses[].type object kailanganFACILITY · FISCAL · OPERATING · OTHER · REGISTERED
company object kailanganNormalized na pagkakakilanlan ng kumpanya. Para sa isang rehistro ang primary_status at hindi ito pasya sa pagsunod.
Mga nested field
company.country object kailanganMga nested field
company.country.code object kailanganAR · BO · BR · CL · CO · EC · PE · PY
company.country.name string kailangancompany.entity_type object kailanganGOVERNMENT_ENTITY · LEGAL_ENTITY · ORGANIZATION
company.id string kailangancompany.incorporation_date union kailangancompany.legal_name string kailangancompany.primary_status union kailanganMga nested field
company.primary_status.code object kailanganACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
company.primary_status.evidence_refs array kailangancompany.primary_status.scope object kailanganCOMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION
company.trade_names array kailangancoverage object kailanganKatayuan at sinuring pinagmulan bawat module. Magkaiba ang unsupported, unavailable, partial at walang record na resulta.
Mga nested field
coverage.activities object kailanganMga nested field
coverage.activities.data_as_of union kailangancoverage.activities.sources_checked array kailangancoverage.activities.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.addresses object kailanganMga nested field
coverage.addresses.data_as_of union kailangancoverage.addresses.sources_checked array kailangancoverage.addresses.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.customs object kailanganMga nested field
coverage.customs.data_as_of union kailangancoverage.customs.sources_checked array kailangancoverage.customs.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.debts object kailanganMga nested field
coverage.debts.data_as_of union kailangancoverage.debts.sources_checked array kailangancoverage.debts.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.extensions object kailanganMga nested field
coverage.extensions.data_as_of union kailangancoverage.extensions.sources_checked array kailangancoverage.extensions.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.facilities object kailanganMga nested field
coverage.facilities.data_as_of union kailangancoverage.facilities.sources_checked array kailangancoverage.facilities.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.identity object kailanganMga nested field
coverage.identity.data_as_of union kailangancoverage.identity.sources_checked array kailangancoverage.identity.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.public_procurement object kailanganMga nested field
coverage.public_procurement.data_as_of union kailangancoverage.public_procurement.sources_checked array kailangancoverage.public_procurement.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.registrations object kailanganMga nested field
coverage.registrations.data_as_of union kailangancoverage.registrations.sources_checked array kailangancoverage.registrations.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.relationships object kailanganMga nested field
coverage.relationships.data_as_of union kailangancoverage.relationships.sources_checked array kailangancoverage.relationships.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.representatives object kailanganMga nested field
coverage.representatives.data_as_of union kailangancoverage.representatives.sources_checked array kailangancoverage.representatives.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.sanctions object kailanganMga nested field
coverage.sanctions.data_as_of union kailangancoverage.sanctions.sources_checked array kailangancoverage.sanctions.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.statuses object kailanganMga nested field
coverage.statuses.data_as_of union kailangancoverage.statuses.sources_checked array kailangancoverage.statuses.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.supervision object kailanganMga nested field
coverage.supervision.data_as_of union kailangancoverage.supervision.sources_checked array kailangancoverage.supervision.status object kailanganAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
customs object kailanganMga inilathalang customs observation at buod. Nasa USD ang FOB values at kilogram ang net weights.
Mga nested field
customs.operations array kailanganMga nested field
customs.operations[].declaration string kailangancustoms.operations[].description union kailangancustoms.operations[].evidence_refs array kailangancustoms.operations[].fob_usd union kailangancustoms.operations[].hs_code string kailangancustoms.operations[].id string kailangancustoms.operations[].net_weight_kg union kailangancustoms.operations[].operation_date union kailangancustoms.operations[].operation_type object kailanganEXPORT · IMPORT
customs.operations[].partner_country union kailangancustoms.summary union kailanganMga nested field
customs.summary.first_operation_date union kailangancustoms.summary.last_operation_date union kailangancustoms.summary.operation_count integer kailangancustoms.summary.total_fob_usd union kailangancustoms.summary.total_net_weight_kg union kailangandebts array kailanganMga inilathalang obserbasyon ng utang. Panatilihin ang halaga, currency, panahon ng pag-uulat at ebidensiya.
Mga nested field
debts[].amount union kailanganMga nested field
debts[].amount.amount string kailangandebts[].amount.currency string kailangandebts[].evidence_refs array kailangandebts[].id string kailangandebts[].observed_at union kailangandebts[].status object kailanganPUBLISHED · SETTLED · UNKNOWN
debts[].type string kailanganevidence array kailanganEbidensiya sa bawat pahayag. Iugnay ang evidence_refs sa mga stable ID na ito; banggitin ang pinagmulan at verification URL.
Mga nested field
evidence[].claims array kailanganevidence[].data_as_of union kailanganevidence[].id string kailanganevidence[].license union kailanganevidence[].publisher object kailanganMga nested field
evidence[].publisher.acronym union kailanganevidence[].publisher.country string kailanganevidence[].publisher.local_name string kailanganevidence[].reporting_basis object kailanganCOMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY
evidence[].retrieved_at string kailangan^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$
evidence[].source_id string kailanganevidence[].source_record object kailanganevidence[].verification_url union kailanganextensions object kailanganKaragdagang datos ng pinagmulan na labas sa normalized na module; basahin ang source contract nito.
facilities array kailanganMga pasilidad na nakatala sa available na opisyal na pinagmulan.
Mga nested field
facilities[].address union kailanganMga nested field
facilities[].address.administrative_area union kailanganfacilities[].address.country object kailanganAR · BO · BR · CL · CO · EC · PE · PY
facilities[].address.evidence_refs array kailanganfacilities[].address.full_address union kailanganfacilities[].address.id string kailanganfacilities[].address.line_1 union kailanganfacilities[].address.line_2 union kailanganfacilities[].address.local_subdivision_code union kailanganfacilities[].address.locality union kailanganfacilities[].address.postal_code union kailanganfacilities[].address.raw union kailanganfacilities[].address.type object kailanganFACILITY · FISCAL · OPERATING · OTHER · REGISTERED
facilities[].evidence_refs array kailanganfacilities[].id string kailanganfacilities[].name union kailanganfacilities[].status union kailanganfacilities[].type string kailanganidentifiers array kailanganMga tax identifier ng kumpanya ayon sa bansa. Panatilihin bilang string, kasama ang mga unang zero.
Mga nested field
identifiers[].check_digit union kailanganidentifiers[].country object kailanganAR · BO · BR · CL · CO · EC · PE · PY
identifiers[].evidence_refs array kailanganidentifiers[].formatted string kailanganidentifiers[].local_name string kailanganidentifiers[].scheme object kailanganAR_CUIT · BO_NIT · BR_CNPJ · CL_RUT · CO_NIT · EC_RUC · PE_RUC · PY_RUC
identifiers[].type object kailanganTAX_ID
identifiers[].value string kailanganmeta object kailanganMetadata ng request, mga hiniling na module at palatandaan ng bahagyang resulta. Palaging zero ang lumang credits_charged; libre ang access.
Mga nested field
meta.credits_charged integer kailanganmeta.generated_at string kailangan^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$
meta.locale string kailanganmeta.partial boolean kailanganmeta.request_id string kailanganmeta.requested_modules array kailanganpublic_procurement object kailanganMga rehistro ng supplier at proseso ng procurement na pinananatiling magkahiwalay na obserbasyon.
Mga nested field
public_procurement.processes array kailanganMga nested field
public_procurement.processes[].amount union kailanganMga nested field
public_procurement.processes[].amount.amount string kailanganpublic_procurement.processes[].amount.currency string kailanganpublic_procurement.processes[].date union kailanganpublic_procurement.processes[].evidence_refs array kailanganpublic_procurement.processes[].id string kailanganpublic_procurement.processes[].role object kailanganBUYER · CONSORTIUM_MEMBER · OTHER · SUPPLIER
public_procurement.processes[].status union kailanganpublic_procurement.processes[].title union kailanganpublic_procurement.supplier_registrations array kailanganMga nested field
public_procurement.supplier_registrations[].authority_name string kailanganpublic_procurement.supplier_registrations[].evidence_refs array kailanganpublic_procurement.supplier_registrations[].id string kailanganpublic_procurement.supplier_registrations[].local_name string kailanganpublic_procurement.supplier_registrations[].registered_at union kailanganpublic_procurement.supplier_registrations[].status object kailanganACTIVE · CANCELLED · INACTIVE · SUSPENDED · UNKNOWN
registrations array kailanganMga rehistro sa sinuring opisyal na dataset; hindi kumpleto ang saklaw.
Mga nested field
registrations[].authority object kailanganMga nested field
registrations[].authority.country object kailanganAR · BO · BR · CL · CO · EC · PE · PY
registrations[].authority.local_name string kailanganregistrations[].authority.name string kailanganregistrations[].event union kailanganregistrations[].evidence_refs array kailanganregistrations[].id string kailanganregistrations[].is_current union kailanganregistrations[].number union kailanganregistrations[].raw_status union kailanganregistrations[].registered_at union kailanganregistrations[].renewed_at union kailanganregistrations[].status object kailanganACTIVE · CANCELLED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
registrations[].type object kailanganCOMMERCIAL_REGISTRATION · OTHER · PUBLIC_PROCUREMENT_SUPPLIER · REGULATORY_REGISTRATION · TAX_REGISTRATION
relationships array kailanganMga relasyong inilathala ng pinagmulan; huwag maghinuha ng hindi isiniwalat na pagmamay-ari.
Mga nested field
relationships[].effective_from union kailanganrelationships[].effective_to union kailanganrelationships[].evidence_refs array kailanganrelationships[].id string kailanganrelationships[].subject_identifier union kailanganrelationships[].subject_name union kailanganrelationships[].type string kailanganrepresentatives array kailanganMga inilathalang tungkulin at legal na representasyon; hindi ito pagtukoy ng tunay na may-ari.
Mga nested field
representatives[].effective_from union kailanganrepresentatives[].effective_to union kailanganrepresentatives[].evidence_refs array kailanganrepresentatives[].id string kailanganrepresentatives[].is_current union kailanganrepresentatives[].name string kailanganrepresentatives[].role string kailangansanctions array kailanganMga sanction record na nakita sa sinuring pinagmulan. Hindi clearance ang walang lamang array.
Mga nested field
sanctions[].amount union kailanganMga nested field
sanctions[].amount.amount string kailangansanctions[].amount.currency string kailangansanctions[].authority_name string kailangansanctions[].decision_date union kailangansanctions[].decision_reference union kailangansanctions[].effective_from union kailangansanctions[].effective_to union kailangansanctions[].evidence_refs array kailangansanctions[].id string kailangansanctions[].raw_type union kailangansanctions[].status object kailanganACTIVE · COMPLETED · EXPIRED · UNKNOWN
sanctions[].title union kailangansanctions[].type string kailanganschema_version object kailanganBersiyon ng response contract; gamitin upang matukoy ang mga di-compatible na pagbabago sa schema.
1.0
sources array kailanganMga sinuring dataset at tahasang freshness dates. Hindi petsa ng obserbasyon ang oras ng import.
Mga nested field
sources[].coverage object kailanganMga nested field
sources[].coverage.from union kailangansources[].coverage.to union kailangansources[].data_as_of union kailangansources[].dataset_name string kailangansources[].expected_update_frequency object kailanganDAILY · MANUAL · MONTHLY · UNKNOWN · WEEKLY · YEARLY
sources[].freshness object kailanganCURRENT · DELAYED · STALE · UNKNOWN
sources[].id string kailangansources[].last_imported_at union kailangansources[].latest_observation_at union kailangansources[].publisher_name string kailangansources[].reporting_basis object kailanganCOMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY
sources[].source_updated_at union kailangansources[].verification_url union kailanganstatuses array kailanganMagkahiwalay na obserbasyon ng rehistro. Panatilihin ang saklaw, orihinal na label at ebidensiya sa halip na gumawa ng pangkalahatang pasya.
Mga nested field
statuses[].code object kailanganACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
statuses[].effective_from union kailanganstatuses[].effective_to union kailanganstatuses[].evidence_refs array kailanganstatuses[].explanation union kailanganstatuses[].id string kailanganstatuses[].label string kailanganstatuses[].raw object kailanganMga nested field
statuses[].raw.language string kailanganstatuses[].raw.value string kailanganstatuses[].scope object kailanganCOMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION
supervision array kailanganMga obserbasyon ng sectoral supervision o rehistro mula sa sinuring awtoridad.
Mga nested field
supervision[].authority_name string kailangansupervision[].evidence_refs array kailangansupervision[].id string kailangansupervision[].registration_type string kailangansupervision[].status union kailanganIskema ng tugon
{
"$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
}400Hindi wastong tax ID para sa bansa
401Nawawala o hindi wastong api key
404Hindi nahanap ang kumpanya
429Lumampas sa limitasyon ng request
501Hindi pa kasama ang bansa sa pangkalahatang kontrata
503Hindi available o luma ang kasalukuyang semantic readiness receipt
Halimbawang JSON
Halimbawa ng schema lamang. Hindi ito live na tugon.
{
"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"
}
]
}Pinagmulan at mga limitasyon
Nag-iiba ang saklaw ayon sa bansa at pampublikong source. Ang nawawalang field ay hindi patunay na wala ang katotohanan. Maaaring maantala o magkamali ang mga rehistro; suriin ang ebidensya at petsa bago gamitin ang resulta.