Unibersal na API ng kumpanya · getUniversalCompany
OpenAPI

Pangkalahatang profile ng kumpanya sa LATAM

GET 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

  1. Kung pangalan lang ang mayroon, maghanap sa registry ng bansa at kumpirmahin ang kumpanya. Hindi natatanging pagkakakilanlan ang magkaparehong pangalan.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Tingnan ang mga available na kontrata ng source

Kailangan ng authentication. Gumagamit ang REST request ng Latinfo api key. Idinaragdag ng console ang authorization header at hindi iniimbak ang key.

Mga parameter

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

ISO 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
taxIdstringPathkailangan

Gamitin 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-Of

Dating alias ng oras ng import. Gamitin ang mga tahasang freshness field sa sources[].

X-Latinfo-Imported-At

date-time

X-Source-Updated-At

date-time

X-Latest-Observation-At

date

X-Expected-Update-Frequency

string

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

string

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

uri

X-Credits-Cost

integer

Content-Type: application/json

Mga field ng tugon

activities array kailangan

Mga gawaing pang-ekonomiya na may orihinal na lokal na classification at suportadong international crosswalk.

Mga nested field
activities[].evidence_refs array kailangan
activities[].id string kailangan
activities[].international union kailangan
Mga nested field
activities[].international.code string kailangan
activities[].international.description string kailangan
activities[].international.level object kailangan

CLASS · DIVISION · GROUP · SECTION

activities[].international.mapping_method object kailangan

OFFICIAL_CROSSWALK · REVIEWED_CROSSWALK

activities[].international.mapping_relation object kailangan

APPROXIMATE · EXACT · MANY_TO_ONE · ONE_TO_MANY

activities[].international.revision object kailangan

4

activities[].international.system object kailangan

ISIC_REV4

activities[].local object kailangan
Mga nested field
activities[].local.code union kailangan
activities[].local.description union kailangan
activities[].local.revision union kailangan
activities[].local.system string kailangan
activities[].role object kailangan

OTHER · PRIMARY · SECONDARY

addresses array kailangan

Mga address mula sa sinuring pampublikong pinagmulan; hindi mga lokasyon ng operasyon na independiyenteng napatunayan.

Mga nested field
addresses[].administrative_area union kailangan
addresses[].country object kailangan

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

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

FACILITY · FISCAL · OPERATING · OTHER · REGISTERED

company object kailangan

Normalized na pagkakakilanlan ng kumpanya. Para sa isang rehistro ang primary_status at hindi ito pasya sa pagsunod.

Mga nested field
company.country object kailangan
Mga nested field
company.country.code object kailangan

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

company.country.name string kailangan
company.entity_type object kailangan

GOVERNMENT_ENTITY · LEGAL_ENTITY · ORGANIZATION

company.id string kailangan
company.incorporation_date union kailangan
company.legal_name string kailangan
company.primary_status union kailangan
Mga nested field
company.primary_status.code object kailangan

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

company.primary_status.evidence_refs array kailangan
company.primary_status.scope object kailangan

COMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION

company.trade_names array kailangan
coverage object kailangan

Katayuan at sinuring pinagmulan bawat module. Magkaiba ang unsupported, unavailable, partial at walang record na resulta.

Mga nested field
coverage.activities object kailangan
Mga nested field
coverage.activities.data_as_of union kailangan
coverage.activities.sources_checked array kailangan
coverage.activities.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.addresses object kailangan
Mga nested field
coverage.addresses.data_as_of union kailangan
coverage.addresses.sources_checked array kailangan
coverage.addresses.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.customs object kailangan
Mga nested field
coverage.customs.data_as_of union kailangan
coverage.customs.sources_checked array kailangan
coverage.customs.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.debts object kailangan
Mga nested field
coverage.debts.data_as_of union kailangan
coverage.debts.sources_checked array kailangan
coverage.debts.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.extensions object kailangan
Mga nested field
coverage.extensions.data_as_of union kailangan
coverage.extensions.sources_checked array kailangan
coverage.extensions.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.facilities object kailangan
Mga nested field
coverage.facilities.data_as_of union kailangan
coverage.facilities.sources_checked array kailangan
coverage.facilities.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.identity object kailangan
Mga nested field
coverage.identity.data_as_of union kailangan
coverage.identity.sources_checked array kailangan
coverage.identity.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.public_procurement object kailangan
Mga nested field
coverage.public_procurement.data_as_of union kailangan
coverage.public_procurement.sources_checked array kailangan
coverage.public_procurement.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.registrations object kailangan
Mga nested field
coverage.registrations.data_as_of union kailangan
coverage.registrations.sources_checked array kailangan
coverage.registrations.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.relationships object kailangan
Mga nested field
coverage.relationships.data_as_of union kailangan
coverage.relationships.sources_checked array kailangan
coverage.relationships.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.representatives object kailangan
Mga nested field
coverage.representatives.data_as_of union kailangan
coverage.representatives.sources_checked array kailangan
coverage.representatives.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.sanctions object kailangan
Mga nested field
coverage.sanctions.data_as_of union kailangan
coverage.sanctions.sources_checked array kailangan
coverage.sanctions.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.statuses object kailangan
Mga nested field
coverage.statuses.data_as_of union kailangan
coverage.statuses.sources_checked array kailangan
coverage.statuses.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.supervision object kailangan
Mga nested field
coverage.supervision.data_as_of union kailangan
coverage.supervision.sources_checked array kailangan
coverage.supervision.status object kailangan

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

customs object kailangan

Mga inilathalang customs observation at buod. Nasa USD ang FOB values at kilogram ang net weights.

Mga nested field
customs.operations array kailangan
Mga nested field
customs.operations[].declaration string kailangan
customs.operations[].description union kailangan
customs.operations[].evidence_refs array kailangan
customs.operations[].fob_usd union kailangan
customs.operations[].hs_code string kailangan
customs.operations[].id string kailangan
customs.operations[].net_weight_kg union kailangan
customs.operations[].operation_date union kailangan
customs.operations[].operation_type object kailangan

EXPORT · IMPORT

customs.operations[].partner_country union kailangan
customs.summary union kailangan
Mga nested field
customs.summary.first_operation_date union kailangan
customs.summary.last_operation_date union kailangan
customs.summary.operation_count integer kailangan
customs.summary.total_fob_usd union kailangan
customs.summary.total_net_weight_kg union kailangan
debts array kailangan

Mga inilathalang obserbasyon ng utang. Panatilihin ang halaga, currency, panahon ng pag-uulat at ebidensiya.

Mga nested field
debts[].amount union kailangan
Mga nested field
debts[].amount.amount string kailangan
debts[].amount.currency string kailangan
debts[].evidence_refs array kailangan
debts[].id string kailangan
debts[].observed_at union kailangan
debts[].status object kailangan

PUBLISHED · SETTLED · UNKNOWN

debts[].type string kailangan
evidence array kailangan

Ebidensiya 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 kailangan
evidence[].data_as_of union kailangan
evidence[].id string kailangan
evidence[].license union kailangan
evidence[].publisher object kailangan
Mga nested field
evidence[].publisher.acronym union kailangan
evidence[].publisher.country string kailangan
evidence[].publisher.local_name string kailangan
evidence[].reporting_basis object kailangan

COMPANY_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 kailangan
evidence[].source_record object kailangan
evidence[].verification_url union kailangan
extensions object kailangan

Karagdagang datos ng pinagmulan na labas sa normalized na module; basahin ang source contract nito.

facilities array kailangan

Mga pasilidad na nakatala sa available na opisyal na pinagmulan.

Mga nested field
facilities[].address union kailangan
Mga nested field
facilities[].address.administrative_area union kailangan
facilities[].address.country object kailangan

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

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

FACILITY · FISCAL · OPERATING · OTHER · REGISTERED

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

Mga tax identifier ng kumpanya ayon sa bansa. Panatilihin bilang string, kasama ang mga unang zero.

Mga nested field
identifiers[].check_digit union kailangan
identifiers[].country object kailangan

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

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

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

identifiers[].type object kailangan

TAX_ID

identifiers[].value string kailangan
meta object kailangan

Metadata 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 kailangan
meta.generated_at string kailangan

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

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

Mga rehistro ng supplier at proseso ng procurement na pinananatiling magkahiwalay na obserbasyon.

Mga nested field
public_procurement.processes array kailangan
Mga nested field
public_procurement.processes[].amount union kailangan
Mga nested field
public_procurement.processes[].amount.amount string kailangan
public_procurement.processes[].amount.currency string kailangan
public_procurement.processes[].date union kailangan
public_procurement.processes[].evidence_refs array kailangan
public_procurement.processes[].id string kailangan
public_procurement.processes[].role object kailangan

BUYER · CONSORTIUM_MEMBER · OTHER · SUPPLIER

public_procurement.processes[].status union kailangan
public_procurement.processes[].title union kailangan
public_procurement.supplier_registrations array kailangan
Mga nested field
public_procurement.supplier_registrations[].authority_name string kailangan
public_procurement.supplier_registrations[].evidence_refs array kailangan
public_procurement.supplier_registrations[].id string kailangan
public_procurement.supplier_registrations[].local_name string kailangan
public_procurement.supplier_registrations[].registered_at union kailangan
public_procurement.supplier_registrations[].status object kailangan

ACTIVE · CANCELLED · INACTIVE · SUSPENDED · UNKNOWN

registrations array kailangan

Mga rehistro sa sinuring opisyal na dataset; hindi kumpleto ang saklaw.

Mga nested field
registrations[].authority object kailangan
Mga nested field
registrations[].authority.country object kailangan

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

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

ACTIVE · CANCELLED · INACTIVE · PENDING · SUSPENDED · UNKNOWN

registrations[].type object kailangan

COMMERCIAL_REGISTRATION · OTHER · PUBLIC_PROCUREMENT_SUPPLIER · REGULATORY_REGISTRATION · TAX_REGISTRATION

relationships array kailangan

Mga relasyong inilathala ng pinagmulan; huwag maghinuha ng hindi isiniwalat na pagmamay-ari.

Mga nested field
relationships[].effective_from union kailangan
relationships[].effective_to union kailangan
relationships[].evidence_refs array kailangan
relationships[].id string kailangan
relationships[].subject_identifier union kailangan
relationships[].subject_name union kailangan
relationships[].type string kailangan
representatives array kailangan

Mga inilathalang tungkulin at legal na representasyon; hindi ito pagtukoy ng tunay na may-ari.

Mga nested field
representatives[].effective_from union kailangan
representatives[].effective_to union kailangan
representatives[].evidence_refs array kailangan
representatives[].id string kailangan
representatives[].is_current union kailangan
representatives[].name string kailangan
representatives[].role string kailangan
sanctions array kailangan

Mga sanction record na nakita sa sinuring pinagmulan. Hindi clearance ang walang lamang array.

Mga nested field
sanctions[].amount union kailangan
Mga nested field
sanctions[].amount.amount string kailangan
sanctions[].amount.currency string kailangan
sanctions[].authority_name string kailangan
sanctions[].decision_date union kailangan
sanctions[].decision_reference union kailangan
sanctions[].effective_from union kailangan
sanctions[].effective_to union kailangan
sanctions[].evidence_refs array kailangan
sanctions[].id string kailangan
sanctions[].raw_type union kailangan
sanctions[].status object kailangan

ACTIVE · COMPLETED · EXPIRED · UNKNOWN

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

Bersiyon ng response contract; gamitin upang matukoy ang mga di-compatible na pagbabago sa schema.

1.0

sources array kailangan

Mga sinuring dataset at tahasang freshness dates. Hindi petsa ng obserbasyon ang oras ng import.

Mga nested field
sources[].coverage object kailangan
Mga nested field
sources[].coverage.from union kailangan
sources[].coverage.to union kailangan
sources[].data_as_of union kailangan
sources[].dataset_name string kailangan
sources[].expected_update_frequency object kailangan

DAILY · MANUAL · MONTHLY · UNKNOWN · WEEKLY · YEARLY

sources[].freshness object kailangan

CURRENT · DELAYED · STALE · UNKNOWN

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

COMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY

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

Magkahiwalay 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 kailangan

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

statuses[].effective_from union kailangan
statuses[].effective_to union kailangan
statuses[].evidence_refs array kailangan
statuses[].explanation union kailangan
statuses[].id string kailangan
statuses[].label string kailangan
statuses[].raw object kailangan
Mga nested field
statuses[].raw.language string kailangan
statuses[].raw.value string kailangan
statuses[].scope object kailangan

COMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION

supervision array kailangan

Mga obserbasyon ng sectoral supervision o rehistro mula sa sinuring awtoridad.

Mga nested field
supervision[].authority_name string kailangan
supervision[].evidence_refs array kailangan
supervision[].id string kailangan
supervision[].registration_type string kailangan
supervision[].status union kailangan
Iskema 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
Walang nakadokumentong response body.
401Nawawala o hindi wastong api key
Walang nakadokumentong response body.
404Hindi nahanap ang kumpanya
Walang nakadokumentong response body.
429Lumampas sa limitasyon ng request
Walang nakadokumentong response body.
501Hindi pa kasama ang bansa sa pangkalahatang kontrata
Walang nakadokumentong response body.
503Hindi available o luma ang kasalukuyang semantic readiness receipt
Walang nakadokumentong response body.
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.