{"openapi":"3.1.0","info":{"title":"VAT Tools public API (v1)","version":"1.0.0","description":"Canonical VAT validation, company search, legal-entity verification and VAT discovery operations.\n\nRate limits: accepted requests are bounded per credential. Successful responses carry `RateLimit-Limit`, `RateLimit-Remaining` (when the counter is readable) and `RateLimit-Reset` in seconds. Rejections return `429` with a `Retry-After` header when available. Every response with status 400 or above is `application/json` `{\"error\":{\"code\",\"message\"}}`, drawn from the published per-status error components; recovery data travels only in headers. Every response carries a server-generated `X-Request-Id`; quote it to support. Back off per `Retry-After` and reuse the same `Idempotency-Key` when retrying one logical operation. Bulk jobs are the supported path for sustained workloads."},"servers":[{"url":"https://api.vat.tools","description":"Production API"}],"tags":[{"name":"VAT validation","description":"Check one VAT number with the competent tax authority and keep the result."},{"name":"Company identity","description":"Search, resolve and verify legal entities and their identifiers against official registers."},{"name":"VAT discovery","description":"Find the VAT registration that belongs to a known legal entity."},{"name":"Records and history","description":"Read saved results, annotate them and download their retained records and evidence."},{"name":"Counterparties","description":"List the counterparties derived from your saved results."},{"name":"Monitors","description":"Watch VAT identifiers on a schedule and read the changes observed between definitive checks."},{"name":"Bulk jobs","description":"Upload a CSV, start, resume or cancel the job, then review and export its rows."},{"name":"Tax and rates","description":"Assess VAT treatment, calculate VAT and read reference rates."},{"name":"Account","description":"Organization settings and usage for the authenticated organization."},{"name":"Capabilities","description":"What the API supports by country, operation and environment."},{"name":"Webhooks","description":"Manage signed webhook subscriptions and review delivery attempts."}],"components":{"headers":{"RequestId":{"description":"Server-generated identifier for this response (UUID v4). Quote it to support. It is never taken from the request.","required":true,"schema":{"type":"string","format":"uuid"}},"RateLimitLimit":{"description":"Maximum requests accepted in the current window. Sent on responses to authenticated requests that were admitted; absent on authentication failures and on 429 responses raised during authentication.","required":false,"schema":{"type":"integer","minimum":0}},"RateLimitRemaining":{"description":"Requests left in the current window. Sent only when the counter could be read; absent on authentication failures and on 429 responses raised during authentication.","required":false,"schema":{"type":"integer","minimum":0}},"RateLimitReset":{"description":"Seconds until the current window fully clears (an upper bound). Sent on responses to authenticated requests that were admitted; absent on authentication failures and on 429 responses raised during authentication.","required":false,"schema":{"type":"integer","minimum":0}},"RetryAfter":{"description":"Seconds to wait before retrying, when known.","required":false,"schema":{"type":"integer","minimum":0}},"OperationIdempotencyKey":{"description":"Key to reuse with this same normalized request.","schema":{"type":"string"}},"OperationId":{"description":"The saved run ID.","schema":{"type":"string","format":"uuid"}},"OperationIdempotencyReplayed":{"description":"Whether this response recovered an existing saved result.","schema":{"type":"string","enum":["true","false"]}},"OperationUsageCharged":{"description":"Additional units for this HTTP response; always zero for a replay.","schema":{"type":"string","enum":["0","1"]}}},"securitySchemes":{"DeveloperKey":{"type":"http","scheme":"bearer","description":"Organization-owned bearer key with explicit scopes and sandbox or live environment."},"AccountSession":{"type":"apiKey","in":"cookie","name":"better-auth.session_token","description":"Authenticated browser session. Product requests require X-Organization-Id; mutations require the trusted Origin."}},"schemas":{"WebhookEventEnvelopeMonitorCannotSeeV1":{"type":"object","properties":{"id":{"type":"string","pattern":"^evt_[0-9a-f]{32}$"},"type":{"type":"string","enum":["monitor.cannot_see"]},"timestamp":{"type":"string","format":"date-time"},"data":{"$ref":"#/components/schemas/MonitorCannotSeeDataV1"}},"required":["id","type","timestamp","data"],"additionalProperties":false},"MonitorCannotSeeDataV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monitor-events-v1"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"environment":{"type":"string","enum":["live","sandbox"]},"organizationId":{"type":"string","minLength":1,"maxLength":128},"monitorId":{"type":"string","format":"uuid"},"subject":{"$ref":"#/components/schemas/MonitorSubjectV1"},"counterpartyVatId":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"cannotSeeSince":{"type":"string","format":"date-time"},"lastDefinitiveObservedAt":{"type":["string","null"],"format":"date-time"},"thresholdHours":{"type":"integer","minimum":36,"maximum":8760},"cause":{"type":"string","enum":["subject","member_state","vies","our_access"]},"facts":{"type":"array","items":{"type":"object","properties":{"fact":{"$ref":"#/components/schemas/MonitorWatchedFactV1"},"lastNotObservedReason":{"$ref":"#/components/schemas/MonitorNotObservedReasonV1"}},"required":["fact","lastNotObservedReason"],"additionalProperties":false},"minItems":1,"maxItems":8},"detectedAt":{"type":"string","format":"date-time"}},"required":["schemaVersion","disclosurePolicyVersion","environment","organizationId","monitorId","subject","counterpartyVatId","cannotSeeSince","lastDefinitiveObservedAt","thresholdHours","cause","facts","detectedAt"],"additionalProperties":false},"MonitorSubjectV1":{"oneOf":[{"$ref":"#/components/schemas/MonitorVatIdSubjectV1"},{"$ref":"#/components/schemas/MonitorCompanySubjectV1"}],"discriminator":{"propertyName":"kind","mapping":{"vat_id":"#/components/schemas/MonitorVatIdSubjectV1","company":"#/components/schemas/MonitorCompanySubjectV1"}}},"MonitorVatIdSubjectV1":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_id"]},"countryCode":{"type":"string","enum":["AT","BE","BG","HR","CY","CZ","DK","EE","FI","FR","DE","EL","HU","IE","IT","LV","LT","LU","MT","NL","PL","PT","RO","SK","SI","ES","SE","XI"]},"vatNumber":{"type":"string","pattern":"^[A-Z0-9+*]{2,32}$"}},"required":["kind","countryCode","vatNumber"],"additionalProperties":false},"MonitorCompanySubjectV1":{"type":"object","properties":{"kind":{"type":"string","enum":["company"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"registryId":{"type":"string","minLength":1,"maxLength":160}},"required":["kind","jurisdiction","registryId"],"additionalProperties":false},"MonitorWatchedFactV1":{"type":"string","enum":["vat_status","vat_registered_name","vat_registered_address","legal_status","insolvency","legal_name","legal_form","registered_address"]},"MonitorNotObservedReasonV1":{"type":["string","null"],"enum":["source_unavailable","source_rate_limited","source_busy","not_found_at_source","absent_from_active_snapshot","out_of_scope","snapshot_stale","snapshot_behind_signal","not_disclosed","credentials_missing","parser_drift","input_rejected","number_blocked","local_refusal","unsupported","vies_stopped","delivery_withheld","not_permitted",null]},"WebhookEventEnvelopeVerificationCompletedV1":{"type":"object","properties":{"id":{"type":"string","pattern":"^evt_[0-9a-f]{32}$"},"type":{"type":"string","enum":["verification.completed"]},"timestamp":{"type":"string","format":"date-time"},"data":{"$ref":"#/components/schemas/DisclosurePublicOperationPayload"}},"required":["id","type","timestamp","data"],"additionalProperties":false},"DisclosurePublicOperationPayload":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicVerificationDelivery"},{"$ref":"#/components/schemas/DisclosurePublicResolutionDelivery"},{"$ref":"#/components/schemas/DisclosurePublicWebCompanyDelivery"},{"$ref":"#/components/schemas/DisclosurePublicIdentifierChecksDelivery"},{"$ref":"#/components/schemas/DisclosurePublicLegacyCompanyDelivery"}]},"DisclosurePublicVerificationDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"operation":{"$ref":"#/components/schemas/DisclosurePublicOperation"},"subject":{"$ref":"#/components/schemas/DisclosurePublicDeliverySubject"},"usage":{"$ref":"#/components/schemas/DisclosurePublicUsage"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"staleEvidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"claims":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicClaim"},"maxItems":1000},"relationships":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicRelationship"},"maxItems":1000},"conflicts":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicConflict"},"maxItems":100},"issues":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicIssue"},"maxItems":100},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100},"result":{"$ref":"#/components/schemas/DisclosurePublicVerificationResultDelivery"}},"required":["schemaVersion","disclosurePolicyVersion","operation","subject","usage","evidence","fieldTrust","result"],"additionalProperties":false},"DisclosurePublicOperation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"status":{"type":"string","enum":["completed"]},"environment":{"type":"string","enum":["live","sandbox"]},"createdAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"replayed":{"type":"boolean"}},"required":["id","kind","status","environment","createdAt","completedAt","replayed"],"additionalProperties":false},"DisclosurePublicDeliverySubject":{"type":"object","properties":{"entity":{"$ref":"#/components/schemas/DisclosurePublicEntityIdentity"},"establishment":{"$ref":"#/components/schemas/DisclosurePublicEntityIdentity"},"foreignRegistration":{"$ref":"#/components/schemas/DisclosurePublicEntityIdentity"},"customerAccount":{"type":"object","properties":{"reference":{"type":"string","maxLength":8192}},"required":["reference"],"additionalProperties":false},"search":{"$ref":"#/components/schemas/DisclosurePublicDeliveryInput"},"identifiers":{"$ref":"#/components/schemas/DisclosurePublicIdentifierInput"},"vatRegistration":{"type":"object","properties":{"taxJurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"vatPrefix":{"type":"string","pattern":"^[A-Z]{2}$"},"vatIdentifier":{"type":"string","maxLength":8192},"authorityScope":{"type":"string","enum":["vat_registration"]}},"required":["taxJurisdiction","vatPrefix","vatIdentifier"],"additionalProperties":false},"publicCandidate":{"type":"object","properties":{"searchOperationId":{"type":"string","format":"uuid"},"candidateIndex":{"type":"integer","minimum":0,"maximum":100},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"legalName":{"type":"string","maxLength":8192},"companyId":{"type":["string","null"],"maxLength":8192},"taxId":{"type":["string","null"],"maxLength":8192},"vatId":{"type":["string","null"],"maxLength":8192}},"required":["searchOperationId","candidateIndex","jurisdiction","legalName","companyId","taxId","vatId"],"additionalProperties":false}},"additionalProperties":false},"DisclosurePublicEntityIdentity":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"register":{"type":"string","minLength":1,"maxLength":160},"registryId":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","register","registryId"],"additionalProperties":false},"DisclosurePublicDeliveryInput":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"maxItems":40},"query":{"type":"string","maxLength":8192},"registryId":{"type":"string","maxLength":8192},"register":{"type":"string","maxLength":8192},"vatNumber":{"type":"string","maxLength":8192},"vat_id":{"type":"string","maxLength":8192},"legalName":{"type":"string","maxLength":8192},"website":{"type":"string","format":"uri"},"mode":{"type":"string","enum":["live","sandbox"]},"limit":{"type":"integer","minimum":1,"maximum":100},"identifier":{"type":"object","properties":{"type":{"type":"string","enum":["lei","euid","duns","national","registry_id","tax_id","vat_id"]},"value":{"type":"string","maxLength":8192},"scheme":{"type":"string","maxLength":8192}},"required":["type","value"],"additionalProperties":false},"identifierChecks":{"$ref":"#/components/schemas/DisclosurePublicIdentifierInput"},"claims":{"type":"object","properties":{"legalName":{"type":"string","maxLength":8192},"registeredAddress":{"type":"string","maxLength":8192},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"status":{"type":"string","enum":["active","ceased"]},"companyId":{"type":"string","maxLength":8192},"taxId":{"type":"string","maxLength":8192},"vatId":{"type":"string","maxLength":8192},"publishedAddress":{"type":"string","maxLength":8192}},"additionalProperties":false},"validateVat":{"type":"boolean"},"searchOperationId":{"type":"string","format":"uuid"},"candidateIndex":{"type":"integer","minimum":0}},"additionalProperties":false},"DisclosurePublicIdentifierInput":{"type":"object","properties":{"country_code":{"type":"string","pattern":"^[A-Z]{2}$"},"lei":{"type":"string","maxLength":8192},"eori":{"type":"string","maxLength":8192},"peppol_id":{"type":"string","maxLength":8192},"national_id":{"type":"object","properties":{"scheme":{"type":"string","enum":["no.orgnr","fr.siren","fr.siret","gb.crn","ch.uid","de.hrb","es.nif","it.cf","nl.kvk","be.kbo","at.fn","pl.krs","pl.nip","cz.ico","sk.ico","se.orgnr","dk.cvr","fi.ytunnus","ie.cro","pt.nipc","ro.cui","gr.afm","gr.gemi","hu.adoszam","bg.eik","hr.oib","si.maticna","lt.jar","lv.regnr","ee.registrikood","lu.rcs","cy.he","mt.mbr","xi.crn","is.kennitala","ge.id","rs.mb","rs.pib","al.nipt","ua.edrpou","tr.mersis","tr.vkn"]},"value":{"type":"string","minLength":1,"maxLength":80}},"required":["scheme","value"],"additionalProperties":false},"euid":{"type":"string","maxLength":8192},"duns":{"type":"string","maxLength":8192},"expected_legal_name":{"type":"string","maxLength":8192},"mode":{"type":"string","enum":["live"]}},"required":["country_code","mode"],"additionalProperties":false},"DisclosurePublicUsage":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicUsageCompleted"},{"$ref":"#/components/schemas/DisclosurePublicUsageUnsupported"}],"discriminator":{"propertyName":"settlementReason","mapping":{"completed":"#/components/schemas/DisclosurePublicUsageCompleted","unsupported":"#/components/schemas/DisclosurePublicUsageUnsupported","source_unavailable":"#/components/schemas/DisclosurePublicUsageUnsupported","incomplete":"#/components/schemas/DisclosurePublicUsageUnsupported","failed":"#/components/schemas/DisclosurePublicUsageUnsupported","interrupted":"#/components/schemas/DisclosurePublicUsageUnsupported","replayed":"#/components/schemas/DisclosurePublicUsageUnsupported","duplicate":"#/components/schemas/DisclosurePublicUsageUnsupported","cancelled":"#/components/schemas/DisclosurePublicUsageUnsupported","late_result":"#/components/schemas/DisclosurePublicUsageUnsupported"}}},"DisclosurePublicUsageCompleted":{"type":"object","properties":{"meter":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"unitsCharged":{"type":"number","enum":[1]},"settlementReason":{"type":"string","enum":["completed"]}},"required":["meter","unitsCharged","settlementReason"],"additionalProperties":false},"DisclosurePublicUsageUnsupported":{"type":"object","properties":{"meter":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"unitsCharged":{"type":"number","enum":[0]},"settlementReason":{"type":"string","enum":["unsupported","source_unavailable","incomplete","failed","interrupted","replayed","duplicate","cancelled","late_result"]}},"required":["meter","unitsCharged","settlementReason"],"additionalProperties":false},"DisclosurePublicEvidence":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReference"},"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"subject":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceLegalEntity"},{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceEstablishment"},{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceForeignRegistration"},{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceVatRegistration"},{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceCustomerAccount"},{"$ref":"#/components/schemas/DisclosurePublicEntityIdentity"},{"type":"null"}]},"environment":{"type":"string","enum":["live","sandbox"]},"attemptedAt":{"type":["string","null"],"format":"date-time"},"servedAt":{"type":"string","format":"date-time"},"completion":{"type":"string","enum":["complete","incomplete"]},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30}},"required":["id","source"],"additionalProperties":false},"DisclosurePublicEvidenceReference":{"type":"string","pattern":"^evidence-[1-9][0-9]{0,8}$"},"DisclosurePublicSourceDisclosure":{"oneOf":[{"$ref":"#/components/schemas/DisclosureGovernmentPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceNonOfficialPublicRegistry"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceCompanyPublication"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSearchDiscovery"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceUnclassifiedPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSynthetic"}]},"DisclosureGovernmentPublicSource":{"type":"object","properties":{"category":{"type":"string","enum":["government_public_service"]},"name":{"type":"string","minLength":1,"maxLength":240},"url":{"type":"string","format":"uri"},"role":{"type":"string","enum":["vat_validation","vat_association","company_register","government_publication","government_public_service","issuing_authority","e_invoicing_registration"]},"attribution":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":2000},"references":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":8},"sourceDate":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"}]},"dateBasis":{"type":"string","enum":["source_record_updated_at","dataset_published_at","observed_at"]}},"required":["text","references","sourceDate","dateBasis"],"additionalProperties":false},"evidenceRef":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReference"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"maxItems":100},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetPublishedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetImportedAt":{"type":["string","null"],"format":"date-time"},"datasetEffectiveAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]}},"required":["category","name","url","role","evidenceRef","fields","observedAt","retrievedAt"],"additionalProperties":false},"DisclosurePublicEvidenceField":{"type":"string","enum":["legal_name","company_id","tax_id","address","registered_address","published_address","vat_association","vat_validity","standing","legal_form","lifecycle_status","registry_id","domestic_tax_id","country","legal_status","vat_presence","lei","euid","duns","identifier_association","national_vat_registration","peppol_capability","eori","website","brand_name","contact","email","phone","digital_domicile","activity","business_description","registration","capital","relationship","country_detail","incorporation_date","cessation_date"]},"DisclosureAnonymousPublicSourceNonOfficialPublicRegistry":{"type":"object","properties":{"name":{"type":"null"},"url":{"type":"null"},"evidenceRef":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReference"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"maxItems":100},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetPublishedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetImportedAt":{"type":["string","null"],"format":"date-time"},"datasetEffectiveAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"category":{"type":"string","enum":["non_official_public_registry"]},"label":{"type":"string","enum":["Public business directory"]}},"required":["name","url","evidenceRef","fields","observedAt","retrievedAt","category","label"],"additionalProperties":false},"DisclosureAnonymousPublicSourceCompanyPublication":{"type":"object","properties":{"name":{"type":"null"},"url":{"type":"null"},"evidenceRef":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReference"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"maxItems":100},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetPublishedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetImportedAt":{"type":["string","null"],"format":"date-time"},"datasetEffectiveAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"category":{"type":"string","enum":["company_publication"]},"label":{"type":"string","enum":["Company publication"]}},"required":["name","url","evidenceRef","fields","observedAt","retrievedAt","category","label"],"additionalProperties":false},"DisclosureAnonymousPublicSourceSearchDiscovery":{"type":"object","properties":{"name":{"type":"null"},"url":{"type":"null"},"evidenceRef":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReference"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"maxItems":100},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetPublishedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetImportedAt":{"type":["string","null"],"format":"date-time"},"datasetEffectiveAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"category":{"type":"string","enum":["search_discovery"]},"label":{"type":"string","enum":["Search discovery"]}},"required":["name","url","evidenceRef","fields","observedAt","retrievedAt","category","label"],"additionalProperties":false},"DisclosureAnonymousPublicSourceUnclassifiedPublicSource":{"type":"object","properties":{"name":{"type":"null"},"url":{"type":"null"},"evidenceRef":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReference"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"maxItems":100},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetPublishedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetImportedAt":{"type":["string","null"],"format":"date-time"},"datasetEffectiveAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"category":{"type":"string","enum":["unclassified_public_source"]},"label":{"type":"string","enum":["Public source"]}},"required":["name","url","evidenceRef","fields","observedAt","retrievedAt","category","label"],"additionalProperties":false},"DisclosureAnonymousPublicSourceSynthetic":{"type":"object","properties":{"name":{"type":"null"},"url":{"type":"null"},"evidenceRef":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReference"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"maxItems":100},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetPublishedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"datasetImportedAt":{"type":["string","null"],"format":"date-time"},"datasetEffectiveAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"category":{"type":"string","enum":["synthetic"]},"label":{"type":"string","enum":["Synthetic evidence"]}},"required":["name","url","evidenceRef","fields","observedAt","retrievedAt","category","label"],"additionalProperties":false},"DisclosurePublicSubjectReferenceLegalEntity":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"register":{"type":"string","minLength":1,"maxLength":160},"registryId":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","enum":["legal_entity"]}},"required":["jurisdiction","register","registryId","kind"],"additionalProperties":false},"DisclosurePublicSubjectReferenceEstablishment":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"register":{"type":"string","minLength":1,"maxLength":160},"registryId":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","enum":["establishment"]}},"required":["jurisdiction","register","registryId","kind"],"additionalProperties":false},"DisclosurePublicSubjectReferenceForeignRegistration":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"register":{"type":"string","minLength":1,"maxLength":160},"registryId":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","enum":["foreign_registration"]}},"required":["jurisdiction","register","registryId","kind"],"additionalProperties":false},"DisclosurePublicSubjectReferenceVatRegistration":{"type":"object","properties":{"taxJurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"vatPrefix":{"type":"string","pattern":"^[A-Z]{2}$"},"vatIdentifier":{"type":"string","maxLength":8192},"authorityScope":{"type":"string","enum":["vat_registration"]},"kind":{"type":"string","enum":["vat_registration"]}},"required":["taxJurisdiction","vatPrefix","vatIdentifier","kind"],"additionalProperties":false},"DisclosurePublicSubjectReferenceCustomerAccount":{"type":"object","properties":{"kind":{"type":"string","enum":["customer_account"]},"reference":{"type":"string","maxLength":8192}},"required":["kind","reference"],"additionalProperties":false},"DisclosurePublicDisclosureReason":{"type":"string","enum":["government_field_supported","partial_data_correlation","independence_unconfirmed","shared_lineage","insufficient_metadata","unsupported_field","source_stale","source_use_restricted","material_conflict","locator_only","synthetic_evidence"]},"DisclosurePublicClaim":{"type":"object","properties":{"id":{"type":"string","pattern":"^claim-[1-9][0-9]{0,8}$"},"type":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"outcome":{"type":"string","enum":["match","mismatch","unknown","not_requested","confirmed","not_confirmed","conflicting","ambiguous","not_disclosed","not_found","source_unavailable","unsupported"]},"effectiveFrom":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"effectiveTo":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"value":{"oneOf":[{"type":"string","maxLength":8192},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"expectedValue":{"oneOf":[{"type":"string","maxLength":8192},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30}},"required":["id","type","outcome","effectiveFrom","effectiveTo","value","evidenceRefs"],"additionalProperties":false},"DisclosurePublicEvidenceReferences":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReference"},"maxItems":1000},"DisclosurePublicRelationship":{"type":"object","properties":{"id":{"type":"string","pattern":"^relationship-[1-9][0-9]{0,8}$"},"outcome":{"type":"string","enum":["confirmed","derived_candidate","not_confirmed","ambiguous","conflicting","unknown"]},"effectiveFrom":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"effectiveTo":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"type":{"type":"string","enum":["establishment_of","branch_of","foreign_registration_of","vat_registration_of","member_of_vat_group","previous_identity_of","successor_of"]},"from":{"$ref":"#/components/schemas/DisclosurePublicSubjectReference"},"to":{"$ref":"#/components/schemas/DisclosurePublicSubjectReference"},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["id","outcome","effectiveFrom","effectiveTo","type","from","to","evidenceRefs"],"additionalProperties":false},"DisclosurePublicSubjectReference":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceLegalEntity"},{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceEstablishment"},{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceForeignRegistration"},{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceVatRegistration"},{"$ref":"#/components/schemas/DisclosurePublicSubjectReferenceCustomerAccount"}],"discriminator":{"propertyName":"kind","mapping":{"legal_entity":"#/components/schemas/DisclosurePublicSubjectReferenceLegalEntity","establishment":"#/components/schemas/DisclosurePublicSubjectReferenceEstablishment","foreign_registration":"#/components/schemas/DisclosurePublicSubjectReferenceForeignRegistration","vat_registration":"#/components/schemas/DisclosurePublicSubjectReferenceVatRegistration","customer_account":"#/components/schemas/DisclosurePublicSubjectReferenceCustomerAccount"}}},"DisclosurePublicConflict":{"type":"object","properties":{"id":{"type":"string","pattern":"^conflict-[1-9][0-9]{0,8}$"},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"claimRefs":{"type":"array","items":{"type":"string","pattern":"^claim-[1-9][0-9]{0,8}$"},"maxItems":100},"relationshipRefs":{"type":"array","items":{"type":"string","pattern":"^relationship-[1-9][0-9]{0,8}$"},"maxItems":100},"selectedEvidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"resolution":{"type":"string","enum":["unresolved","authority_policy","operator_selected","customer_policy"]},"reason":{"type":"string","enum":["material_conflict"]}},"required":["id","evidenceRefs","claimRefs","relationshipRefs","selectedEvidenceRefs","resolution","reason"],"additionalProperties":false},"DisclosurePublicIssue":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"retryable":{"type":"boolean"},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["reason","retryable","evidenceRefs"],"additionalProperties":false},"DisclosureFieldTrustAssessment":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"score":{"type":["integer","null"],"minimum":0,"maximum":100},"assessment":{"type":"string","enum":["government_supported","partial_correlation","conflicting","unassessed","synthetic"]},"modelVersion":{"type":"string","enum":["field-trust-v1"]},"assessedAt":{"type":"string","format":"date-time"},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"observedPublisherGroups":{"type":"integer","minimum":0,"maximum":1000},"effectiveCorrelationGroups":{"type":"integer","minimum":0,"maximum":1000},"provenIndependentLineages":{"type":"integer","minimum":0,"maximum":1000},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30}},"required":["field","score","assessment","modelVersion","assessedAt","disclosurePolicyVersion","observedPublisherGroups","effectiveCorrelationGroups","provenIndependentLineages","evidenceRefs","reasons"],"additionalProperties":false},"DisclosurePublicVerificationResultDelivery":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicVatValidationResult"},{"$ref":"#/components/schemas/DisclosurePublicCompanySearchResult"},{"$ref":"#/components/schemas/DisclosurePublicCompanyVerificationResult"},{"$ref":"#/components/schemas/DisclosurePublicVatDiscoveryResult"}],"discriminator":{"propertyName":"kind","mapping":{"vat_validation":"#/components/schemas/DisclosurePublicVatValidationResult","company_search":"#/components/schemas/DisclosurePublicCompanySearchResult","company_verification":"#/components/schemas/DisclosurePublicCompanyVerificationResult","vat_discovery":"#/components/schemas/DisclosurePublicVatDiscoveryResult"}}},"DisclosurePublicVatValidationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_validation"]},"outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unavailable","unsupported","valid","invalid"]},"vatNumber":{"type":"string","maxLength":160},"name":{"type":["string","null"],"maxLength":500},"address":{"type":["string","null"],"maxLength":2000},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["kind","outcome"],"additionalProperties":false},"DisclosurePublicCompanySearchResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_search"]},"outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unavailable","unsupported","valid","invalid"]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"company":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompany"},"maxItems":100},"totalResults":{"type":["integer","null"],"minimum":0},"truncated":{"type":"boolean"}},"required":["kind","outcome"],"additionalProperties":false},"DisclosurePublicCompany":{"type":"object","properties":{"entity":{"$ref":"#/components/schemas/DisclosurePublicEntityIdentity"},"legalName":{"type":["string","null"],"maxLength":8192},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"normalizedName":{"type":"string","maxLength":8192},"website":{"type":"string","format":"uri"},"brandName":{"type":["string","null"],"maxLength":8192},"companyId":{"type":["string","null"],"maxLength":8192},"taxId":{"type":["string","null"],"maxLength":8192},"lei":{"type":["string","null"],"maxLength":8192},"leiRegistration":{"type":"object","properties":{"legalJurisdiction":{"type":"string","maxLength":8192},"entityStatus":{"type":"string","maxLength":8192},"registrationStatus":{"type":"string","maxLength":8192},"initialRegistrationDate":{"type":["string","null"],"maxLength":8192},"lastUpdateDate":{"type":["string","null"],"maxLength":8192},"nextRenewalDate":{"type":["string","null"],"maxLength":8192},"goldenCopyPublishedAt":{"type":["string","null"],"maxLength":8192}},"required":["legalJurisdiction","entityStatus","registrationStatus","initialRegistrationDate","lastUpdateDate","nextRenewalDate","goldenCopyPublishedAt"],"additionalProperties":false},"vatId":{"type":["string","null"],"maxLength":8192},"registryId":{"type":"string","maxLength":8192},"registryCountryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"registeredAddress":{"$ref":"#/components/schemas/DisclosurePublicAddress"},"address":{"$ref":"#/components/schemas/DisclosurePublicAddress"},"status":{"type":"string","enum":["active","ceased","unknown"]},"rawStatus":{"type":["string","null"],"maxLength":8192},"legalForm":{"type":["string","null"],"maxLength":8192},"legalFormCode":{"type":["string","null"],"maxLength":8192},"legalEntity":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicLegalEntity"},{"type":"null"}]},"disclosure":{"type":"string","enum":["public","partial","unknown"]},"facts":{"$ref":"#/components/schemas/DisclosurePublicCompanyFacts"},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompanyIdentifier"},"maxItems":200},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"sourceEvidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"maxItems":100},"nationalVatRegistration":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicNationalVat"},{"type":"null"}]},"vatCandidates":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicVatCandidate"},"maxItems":20},"derivedVatCandidate":{"$ref":"#/components/schemas/DisclosurePublicDerivedVatCandidateOutcome"},"vatVies":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["valid","invalid","unavailable"]},"name":{"type":["string","null"],"maxLength":8192},"address":{"type":["string","null"],"maxLength":8192},"checkedAt":{"type":"string","format":"date-time"},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["status","name","address"],"additionalProperties":false},"rank":{"type":"integer","minimum":1,"maximum":100},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicFieldProvenance"},"maxItems":100},"missingFields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicMissingField"},"maxItems":100}},"required":["legalName","jurisdiction","identifiers","evidenceRefs"],"additionalProperties":false},"DisclosurePublicAddress":{"type":"object","properties":{"raw":{"type":["string","null"],"maxLength":8192},"formatted":{"type":["string","null"],"maxLength":8192},"fullAddress":{"type":["string","null"],"maxLength":8192},"country":{"type":["string","null"],"maxLength":8192},"countryCode":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"countryLabel":{"type":["string","null"],"maxLength":8192},"postalCode":{"type":["string","null"],"maxLength":8192},"postal_code":{"type":["string","null"],"maxLength":8192},"locality":{"type":["string","null"],"maxLength":8192},"region":{"type":["string","null"],"maxLength":8192},"street":{"type":["string","null"],"maxLength":8192},"subdivision_code":{"type":["string","null"],"maxLength":8192},"iso_subdivision":{"type":["string","null"],"maxLength":8192},"street_line1":{"type":["string","null"],"maxLength":8192},"street_line2":{"type":["string","null"],"maxLength":8192},"components":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicAddressComponents"},{"type":"null"}]},"normalized":{"type":["object","null"],"properties":{"street":{"type":"string","maxLength":8192},"city":{"type":"string","maxLength":8192},"postalCode":{"type":"string","maxLength":8192},"country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["country"],"additionalProperties":false},"tax_territory":{"$ref":"#/components/schemas/DisclosurePublicAddressTaxTerritory"}},"additionalProperties":false},"DisclosurePublicAddressComponents":{"type":"object","properties":{"street_category":{"type":["string","null"],"maxLength":8192},"street_type":{"type":["string","null"],"maxLength":8192},"street_type_english":{"type":["string","null"],"maxLength":8192},"street_type_abbreviations":{"type":["array","null"],"items":{"type":"string","maxLength":8192},"maxItems":100},"street_name":{"type":["string","null"],"maxLength":8192},"house_number":{"type":["string","null"],"maxLength":8192},"house_number_addition":{"type":["string","null"],"maxLength":8192},"unit":{"type":["string","null"],"maxLength":8192},"district":{"type":["string","null"],"maxLength":8192}},"additionalProperties":false},"DisclosurePublicAddressTaxTerritory":{"type":"object","properties":{"schema_version":{"type":"string","enum":["address-tax-territory.v1"]},"political_country":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"territory":{"type":["string","null"],"enum":["ES_CANARY","ES_MAINLAND_BALEARIC","ES_CEUTA","ES_MELILLA","EU_VAT_STANDARD","FI_ALAND","FR_GUADELOUPE","FR_MARTINIQUE","FR_REUNION","FR_GUYANE","FR_MAYOTTE","FR_SAINT_MARTIN","NON_EU_SAINT_BARTHELEMY","MONACO_FRENCH_VAT_TERRITORY","DE_BUSINGEN","DE_HELGOLAND","IT_LIVIGNO","IT_CAMPIONE",null]},"resolution":{"type":"string","enum":["sourced_location","declared_location","derived_candidate","unknown","conflicting","stale","unsupported"]},"matched_fields":{"type":"array","items":{"type":"string","enum":["raw","country_code","postal_code","locality","region","spanish_province_code","declared_territory_code"]},"maxItems":7},"address_role":{"type":"string","enum":["registered_office","fiscal_domicile","billing","business_establishment","receiving_fixed_establishment","supplying_fixed_establishment","intervening_fixed_establishment","delivery","unknown"]},"eu_vat_goods_scope":{"type":"string","enum":["inside","outside","unknown"]},"eu_vat_services_scope":{"type":"string","enum":["inside","outside","unknown"]},"governing_indirect_tax":{"type":"string","enum":["spanish_iva","igic","finnish_vat","swiss_vat","french_vat_overseas","french_vat_not_applicable","not_reviewed"]},"mapping_version":{"type":"string","enum":["tax-territories.2026-10-13.v1","tax-territories.2026-10-15.v1"]},"warnings":{"type":"array","items":{"type":"string","enum":["postcode_not_validated","historical_address_not_current_establishment","address_validity_unknown","invoice_establishment_unconfirmed","vat_registration_address_not_establishment"]},"maxItems":5},"limitation":{"type":"string","enum":["Location fact only. The place of supply depends on the receiving establishment, which this address does not establish; only a tax assessment determines how tax applies."]},"rule_references":{"oneOf":[{"type":"object","properties":{"schema_version":{"type":"string","enum":["workflow-territory-rule-references.v1"]},"qualification_scope":{"type":"string","enum":["source_reference_only"]},"legal_applicability":{"type":"string","enum":["not_qualified_by_this_fragment"]},"references":{"type":"array","items":{"type":"object","properties":{"use_token":{"type":"string","enum":["derived_geography_rule_reference.v1","derived_legal_rule_reference.v1"]},"content_kind":{"type":"string","enum":["exact_resource_citation"]},"source":{"type":"object","properties":{"kind":{"type":"string","enum":["government"]},"publisher":{"type":"string","minLength":1,"maxLength":240},"service":{"type":"string","minLength":1,"maxLength":240},"jurisdiction":{"type":"string","enum":["ES","EU","DE","CH","IT","FI","FR"]},"evidence_role":{"type":"string","enum":["map_rule","legal_rule"]},"url":{"type":"string","format":"uri"},"notices":{"type":"array","items":{"type":"string","minLength":1,"maxLength":2000},"minItems":1,"maxItems":16}},"required":["kind","publisher","service","jurisdiction","evidence_role","url","notices"],"additionalProperties":false},"document":{"type":"object","properties":{"captured_at":{"type":"string","format":"date-time"},"source_published_at":{"type":["string","null"],"format":"date"},"source_updated_at":{"type":["string","null"],"format":"date"},"revision_kind":{"type":"string","enum":["undated_reference","selected_consolidated_publication","original_publication","updated_guidance_page"]}},"required":["captured_at","source_published_at","source_updated_at","revision_kind"],"additionalProperties":false}},"required":["use_token","content_kind","source","document"],"additionalProperties":false},"minItems":1,"maxItems":20}},"required":["schema_version","qualification_scope","legal_applicability","references"],"additionalProperties":false},{"type":"null"}]}},"required":["schema_version","political_country","territory","resolution","matched_fields","address_role","eu_vat_goods_scope","eu_vat_services_scope","governing_indirect_tax","mapping_version","warnings","limitation","rule_references"],"additionalProperties":false,"description":"Location fact for this address: where it lies for indirect-tax purposes, whether that comes from a postcode candidate or sourced evidence, EU VAT scope for goods and services, and the governing indirect tax where reviewed. It does not say how tax applies to any transaction (see limitation). Delivered with the same meaning on company results, history, evidence downloads, bulk rows and exports; it is saved with the original observation and never recomputed, so results saved before territory existed carry none."},"DisclosurePublicLegalEntity":{"type":"object","properties":{"native_value":{"type":["string","null"],"maxLength":8192},"acronym":{"type":["string","null"],"maxLength":8192},"native_name":{"type":["string","null"],"maxLength":8192},"english_name":{"type":["string","null"],"maxLength":8192},"category":{"type":["string","null"],"maxLength":8192},"iso_elf_code":{"type":["string","null"],"maxLength":8192},"common_analogue":{"type":["string","null"],"maxLength":8192}},"additionalProperties":false},"DisclosurePublicCompanyFacts":{"type":"object","properties":{"schema_version":{"type":"string","enum":["company-facts-public-v1"]},"subject":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"register":{"type":"string","minLength":1,"maxLength":160},"registry_id":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","register","registry_id"],"additionalProperties":false},"observations":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompanyFactObservation"},"minItems":1,"maxItems":200},"truncated":{"type":"boolean"}},"required":["schema_version","subject","observations"],"additionalProperties":false},"DisclosurePublicCompanyFactObservation":{"type":"object","properties":{"fact":{"$ref":"#/components/schemas/DisclosurePublicCompanyFact"},"evidence_refs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"state":{"type":"string","enum":["authority_confirmed","source_attributed","company_claimed","partial_correlation","synthetic"]},"observed_at":{"type":"string","format":"date-time"},"source_record_updated_at":{"oneOf":[{"type":"string","format":"date"},{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["fact","evidence_refs","state","observed_at","source_record_updated_at"],"additionalProperties":false},"DisclosurePublicCompanyFact":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompanyFactName"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactIdentifier"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactAddress"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactLegalForm"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactLifecycle"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactRegistration"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactActivity"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactBusinessDescription"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactCapital"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactRelationship"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactContact"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactRouting"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactArtifact"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactTaxDisclosure"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactRestriction"},{"$ref":"#/components/schemas/DisclosurePublicCompanyFactCountryDetail"}],"discriminator":{"propertyName":"kind","mapping":{"name":"#/components/schemas/DisclosurePublicCompanyFactName","identifier":"#/components/schemas/DisclosurePublicCompanyFactIdentifier","address":"#/components/schemas/DisclosurePublicCompanyFactAddress","legal_form":"#/components/schemas/DisclosurePublicCompanyFactLegalForm","lifecycle":"#/components/schemas/DisclosurePublicCompanyFactLifecycle","registration":"#/components/schemas/DisclosurePublicCompanyFactRegistration","activity":"#/components/schemas/DisclosurePublicCompanyFactActivity","business_description":"#/components/schemas/DisclosurePublicCompanyFactBusinessDescription","capital":"#/components/schemas/DisclosurePublicCompanyFactCapital","relationship":"#/components/schemas/DisclosurePublicCompanyFactRelationship","contact":"#/components/schemas/DisclosurePublicCompanyFactContact","routing":"#/components/schemas/DisclosurePublicCompanyFactRouting","artifact":"#/components/schemas/DisclosurePublicCompanyFactArtifact","tax_disclosure":"#/components/schemas/DisclosurePublicCompanyFactTaxDisclosure","restriction":"#/components/schemas/DisclosurePublicCompanyFactRestriction","country_detail":"#/components/schemas/DisclosurePublicCompanyFactCountryDetail"}}},"DisclosurePublicCompanyFactName":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["name"]},"role":{"type":"string","enum":["legal","trade","former","alias","display"]},"value":{"type":"string","minLength":1,"maxLength":8192},"language":{"type":"string","minLength":1,"maxLength":160}},"required":["kind","role","value"],"additionalProperties":false},"DisclosurePublicCompanyFactIdentifier":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["identifier"]},"role":{"type":"string","enum":["business_register","establishment","domestic_tax","vat","lei","euid","statistical","economic_operator"]},"scheme":{"type":"string","minLength":1,"maxLength":160},"value":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["kind","role","scheme","value","jurisdiction"],"additionalProperties":false},"DisclosurePublicCompanyFactAddress":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["address"]},"role":{"type":"string","enum":["registered","postal","establishment","operating","seat","unspecified"]},"raw":{"type":"string","minLength":1,"maxLength":8192},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"country_label":{"type":"string","minLength":1,"maxLength":8192},"postal_code":{"type":"string","minLength":1,"maxLength":160},"locality":{"type":"string","minLength":1,"maxLength":8192},"region":{"type":"string","minLength":1,"maxLength":8192},"street":{"type":"string","minLength":1,"maxLength":8192},"house_number":{"type":"string","minLength":1,"maxLength":160}},"required":["kind","role","raw"],"additionalProperties":false},"DisclosurePublicCompanyFactLegalForm":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["legal_form"]},"scheme":{"type":"string","minLength":1,"maxLength":160},"code":{"type":"string","minLength":1,"maxLength":160},"label":{"type":"string","minLength":1,"maxLength":8192}},"required":["kind","scheme"],"additionalProperties":false},"DisclosurePublicCompanyFactLifecycle":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["lifecycle"]},"event":{"type":"string","enum":["formation","registration","cessation","liquidation","insolvency","status"]},"date":{"type":"string","format":"date"},"raw_status":{"type":"string","minLength":1,"maxLength":8192}},"required":["kind","event"],"additionalProperties":false},"DisclosurePublicCompanyFactRegistration":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["registration"]},"register":{"type":"string","minLength":1,"maxLength":160},"reference":{"type":"string","minLength":1,"maxLength":8192}},"required":["kind","register","reference"],"additionalProperties":false},"DisclosurePublicCompanyFactActivity":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["activity"]},"scheme":{"type":"string","minLength":1,"maxLength":160},"version":{"type":"string","minLength":1,"maxLength":160},"code":{"type":"string","minLength":1,"maxLength":160},"label":{"type":"string","minLength":1,"maxLength":8192},"nace_code":{"type":"string","pattern":"^\\d{2}(?:\\.\\d{1,2})?$"},"label_en":{"type":"string","minLength":1,"maxLength":8192},"primary":{"type":"boolean"}},"required":["kind","scheme","code"],"additionalProperties":false},"DisclosurePublicCompanyFactBusinessDescription":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["business_description"]},"text":{"type":"string","minLength":1,"maxLength":8192},"language":{"type":"string","pattern":"^[a-z]{2}$"},"original_text":{"type":"string","minLength":1,"maxLength":8192},"original_language":{"type":"string","pattern":"^[a-z]{2}$"},"source_kind":{"type":"string","enum":["statutory_object","statutory_corporate_object","activity_classification","activity_classification_summary","published_company_profile","combined_statutory_and_activity"]}},"required":["kind","text","language","source_kind"],"additionalProperties":false},"DisclosurePublicCompanyFactCapital":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["capital"]},"basis":{"type":"string","enum":["subscribed","paid","authorised","equity","unpaid_contributions","contribution","unspecified"]},"amount":{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"variable":{"type":"boolean"}},"required":["kind","basis"],"additionalProperties":false},"DisclosurePublicCompanyFactRelationship":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["relationship"]},"role":{"type":"string","enum":["parent","branch","representative","unlimited_liability_partner","owner","single_member"]},"party_name":{"type":"string","minLength":1,"maxLength":8192},"party":{"$ref":"#/components/schemas/CompanyRelatedPartyV1"},"party_identifier":{"type":"string","minLength":1,"maxLength":160},"scheme":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"cardinality":{"type":"integer","minimum":0}},"required":["kind","role"],"additionalProperties":false},"CompanyRelatedPartyV1":{"type":"object","properties":{"names":{"type":"array","items":{"type":"string","minLength":1,"maxLength":2000},"minItems":1,"maxItems":20},"identifiers":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","minLength":1,"maxLength":160},"value":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["scheme","value"],"additionalProperties":false},"minItems":1,"maxItems":20},"addresses":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string","enum":["registered","postal","establishment","operating","seat","unspecified"]},"raw":{"type":"string","minLength":1,"maxLength":2000},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"country_label":{"type":"string","minLength":1,"maxLength":2000},"postal_code":{"type":"string","minLength":1,"maxLength":160},"locality":{"type":"string","minLength":1,"maxLength":2000},"region":{"type":"string","minLength":1,"maxLength":2000},"street":{"type":"string","minLength":1,"maxLength":2000},"house_number":{"type":"string","minLength":1,"maxLength":160}},"required":["role","raw"],"additionalProperties":false},"minItems":1,"maxItems":20}},"additionalProperties":false},"DisclosurePublicCompanyFactContact":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["contact"]},"channel":{"type":"string","enum":["email","phone","website","digital_domicile","fax"]},"value":{"type":"string","minLength":1,"maxLength":8192},"e164":{"type":"string","pattern":"^\\+[1-9]\\d{4,14}$"},"country_calling_code":{"type":"string","pattern":"^\\+[1-9]\\d{0,3}$"},"national_number":{"type":"string","minLength":1,"maxLength":160},"phone_type":{"type":"string","enum":["fixed_line","mobile","toll_free","shared_cost","premium_rate","voip","personal_number","pager","uan","unknown"]},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["kind","channel","value"],"additionalProperties":false},"DisclosurePublicCompanyFactRouting":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["routing"]},"role":{"type":"string","enum":["seller_endpoint","buyer_endpoint","buyer_reference","gateway","bank_account"]},"scheme":{"type":"string","minLength":1,"maxLength":160},"value":{"type":["string","null"],"minLength":1,"maxLength":8192}},"required":["kind","role","value"],"additionalProperties":false},"DisclosurePublicCompanyFactArtifact":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["artifact"]},"role":{"type":"string","enum":["filing","accounts","extract","notice"]},"reference":{"type":"string","minLength":1,"maxLength":8192},"published_on":{"type":"string","format":"date"},"evidence_refs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["kind","role","reference"],"additionalProperties":false},"DisclosurePublicCompanyFactTaxDisclosure":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["tax_disclosure"]},"indicator":{"type":"string","enum":["debt_threshold","missing_returns"]},"status":{"type":"string","enum":["reported","not_reported"]},"threshold_amount":{"type":"string","pattern":"^\\d+(?:\\.\\d+)?$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"period_months":{"type":"integer","minimum":1,"maximum":120}},"required":["kind","indicator","status"],"additionalProperties":false},"DisclosurePublicCompanyFactRestriction":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["restriction"]},"purpose":{"type":"string","enum":["direct_marketing"]},"scope":{"type":"string","enum":["source_data"]},"restricted":{"type":"boolean"}},"required":["kind","purpose","scope","restricted"],"additionalProperties":false},"DisclosurePublicCompanyFactCountryDetail":{"type":"object","properties":{"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["country_detail"]},"detail":{"$ref":"#/components/schemas/CompanyCountryDetailV1"}},"required":["kind","detail"],"additionalProperties":false},"CompanyCountryDetailV1":{"oneOf":[{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["CZ"]},"schema_version":{"type":"string","enum":["cz-vat.v1"]},"unreliable_payer":{"type":"boolean"},"ico":{"type":"string","pattern":"^\\d{8}$"},"dic":{"type":"string","minLength":1,"maxLength":160},"spisova_znacka":{"type":"string","minLength":1,"maxLength":2000},"rejstrikovy_soud":{"type":"string","minLength":1,"maxLength":2000},"datova_schranka":{"type":"string","minLength":1,"maxLength":160},"pravni_forma_code":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["PL"]},"schema_version":{"type":"string","enum":["pl-ksef.v1"]},"jst":{"type":"boolean"},"gv":{"type":"boolean"},"krs":{"type":"string","pattern":"^\\d{10}$"},"nip":{"type":"string","pattern":"^\\d{10}$"},"regon":{"type":"string","pattern":"^(?:\\d{9}|\\d{14})$"},"sad_rejonowy":{"type":"string","minLength":1,"maxLength":2000},"kapital_zakladowy":{"type":"string","minLength":1,"maxLength":2000},"forma_prawna":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["RO"]},"schema_version":{"type":"string","enum":["ro-correspondence.v1","ro-onrc.v1"]},"dualist_sa_notice":{"type":"string","minLength":1,"maxLength":2000},"cui":{"type":"string","minLength":1,"maxLength":160},"nr_reg_com":{"type":"string","minLength":1,"maxLength":160},"euid":{"type":"string","minLength":1,"maxLength":160},"caen_code":{"type":"string","minLength":1,"maxLength":160},"stare_inregistrare":{"type":"string","minLength":1,"maxLength":2000},"vat_number":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["ES"]},"schema_version":{"type":"string","enum":["es-borme.v1"]},"registro_mercantil":{"type":"string","minLength":1,"maxLength":2000},"registry_province":{"type":"string","minLength":1,"maxLength":2000},"registry_sheet":{"type":"string","minLength":1,"maxLength":160},"registry_entry":{"type":"string","minLength":1,"maxLength":160},"borme_publication_id":{"type":"string","minLength":1,"maxLength":160},"borme_act_number":{"type":"string","minLength":1,"maxLength":160},"tomo":{"type":"string","minLength":1,"maxLength":160},"libro":{"type":"string","minLength":1,"maxLength":160},"folio":{"type":"string","minLength":1,"maxLength":160},"seccion":{"type":"string","minLength":1,"maxLength":160},"hoja":{"type":"string","minLength":1,"maxLength":160},"inscripcion":{"type":"string","minLength":1,"maxLength":160},"objeto_social":{"type":"string","minLength":1,"maxLength":2000},"sole_shareholder":{"type":"boolean"}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["FR"]},"schema_version":{"type":"string","enum":["fr-sirene.v1"]},"siren":{"type":"string","pattern":"^\\d{9}$"},"hq_siret":{"type":"string","pattern":"^\\d{14}$"},"naf_code":{"type":"string","minLength":1,"maxLength":160},"categorie_entreprise":{"type":"string","minLength":1,"maxLength":160},"rcs_greffe":{"type":"string","minLength":1,"maxLength":2000},"sigle":{"type":"string","minLength":1,"maxLength":2000},"nom_commercial":{"type":"string","minLength":1,"maxLength":2000},"enseignes":{"type":"array","items":{"type":"string","minLength":1,"maxLength":2000},"maxItems":20},"tranche_effectifs":{"type":"string","minLength":1,"maxLength":160},"caractere_employeur":{"type":"boolean"},"ess":{"type":"boolean"},"societe_mission":{"type":"boolean"}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["GB"]},"schema_version":{"type":"string","enum":["gb-companies-house.v1"]},"company_number":{"type":"string","minLength":1,"maxLength":160},"jurisdiction_code":{"type":"string","minLength":1,"maxLength":160},"jurisdiction_region":{"type":"string","enum":["england-wales","scotland","northern-ireland","wales","united-kingdom","foreign"]},"company_type":{"type":"string","minLength":1,"maxLength":160},"sic_codes":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"maxItems":20},"has_insolvency_history":{"type":"boolean"},"has_charges":{"type":"boolean"},"accounts_next_made_up_to":{"type":"string","format":"date"},"confirmation_statement_next_made_up_to":{"type":"string","format":"date"}},"required":["jurisdiction","schema_version","company_number"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["DE"]},"schema_version":{"type":"string","enum":["de-handelsregister.v1"]},"register_court":{"type":"string","minLength":1,"maxLength":2000},"register_court_code":{"type":"string","minLength":1,"maxLength":160},"register_type":{"type":"string","enum":["HRA","HRB","GnR","PR","VR"]},"register_number":{"type":"string","minLength":1,"maxLength":160},"euid":{"type":"string","minLength":1,"maxLength":160},"gegenstand":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version","register_court","register_type","register_number"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["IT"]},"schema_version":{"type":"string","enum":["it-registro-imprese.v1"]},"codice_fiscale":{"type":"string","minLength":1,"maxLength":160},"partita_iva":{"type":"string","pattern":"^\\d{11}$"},"camera_di_commercio":{"type":"string","minLength":1,"maxLength":2000},"cciaa_province":{"type":"string","pattern":"^[A-Z]{2}$"},"rea_number":{"type":"string","minLength":1,"maxLength":160},"pec":{"type":"string","minLength":1,"maxLength":2000},"sdi_code":{"type":"string","pattern":"^[A-Z0-9]{7}$"}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["AT"]},"schema_version":{"type":"string","enum":["at-firmenbuch.v1"]},"firmenbuchnummer":{"type":"string","minLength":1,"maxLength":160},"firmenbuchgericht":{"type":"string","minLength":1,"maxLength":2000},"uid":{"type":"string","minLength":1,"maxLength":160},"gln":{"type":"string","minLength":1,"maxLength":160},"gisa_zahl":{"type":"string","minLength":1,"maxLength":160},"kammer":{"type":"string","minLength":1,"maxLength":2000},"unternehmensgegenstand":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["CH"]},"schema_version":{"type":"string","enum":["ch-zefix.v1"]},"uid":{"type":"string","minLength":1,"maxLength":160},"chid":{"type":"string","minLength":1,"maxLength":160},"ehra_id":{"type":"string","minLength":1,"maxLength":160},"mwst_number":{"type":"string","minLength":1,"maxLength":160},"canton":{"type":"string","pattern":"^[A-Z]{2}$"},"registry_office":{"type":"string","minLength":1,"maxLength":2000},"purpose":{"type":"string","minLength":1,"maxLength":2000},"legal_form_code":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["NL"]},"schema_version":{"type":"string","enum":["nl-kvk.v1"]},"kvk_number":{"type":"string","pattern":"^\\d{8}$"},"rsin":{"type":"string","pattern":"^\\d{9}$"},"vestigingsnummer":{"type":"string","pattern":"^\\d{12}$"},"btw_number":{"type":"string","minLength":1,"maxLength":160},"statutaire_zetel":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["BE"]},"schema_version":{"type":"string","enum":["be-kbo-bce.v1"]},"enterprise_number":{"type":"string","pattern":"^[01]\\d{9}$"},"establishment_unit_number":{"type":"string","minLength":1,"maxLength":160},"rpr_rpm":{"type":"string","minLength":1,"maxLength":2000},"tva_btw_number":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["SE"]},"schema_version":{"type":"string","enum":["se-bolagsverket.v1"]},"organisationsnummer":{"type":"string","pattern":"^\\d{10}$"},"momsregistreringsnummer":{"type":"string","minLength":1,"maxLength":160},"sate":{"type":"string","minLength":1,"maxLength":2000},"f_skatt":{"type":"boolean"},"organisationsform":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["PT"]},"schema_version":{"type":"string","enum":["pt-registo-comercial.v1"]},"nipc":{"type":"string","pattern":"^\\d{9}$"},"nif":{"type":"string","pattern":"^\\d{9}$"},"vat_number":{"type":"string","minLength":1,"maxLength":160},"conservatoria":{"type":"string","minLength":1,"maxLength":2000},"capital_social":{"type":"string","minLength":1,"maxLength":2000},"cae_code":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["DK"]},"schema_version":{"type":"string","enum":["dk-cvr.v1"]},"cvr_number":{"type":"string","pattern":"^\\d{8}$"},"vat_number":{"type":"string","minLength":1,"maxLength":160},"se_number":{"type":"string","pattern":"^\\d{8}$"},"virksomhedsform":{"type":"string","minLength":1,"maxLength":2000},"kommune":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["IE"]},"schema_version":{"type":"string","enum":["ie-cro.v1"]},"cro_number":{"type":"string","pattern":"^\\d{1,8}$"},"vat_number":{"type":"string","minLength":1,"maxLength":160},"tax_reference_number":{"type":"string","minLength":1,"maxLength":160},"company_type":{"type":"string","minLength":1,"maxLength":160},"eircode":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["NO"]},"schema_version":{"type":"string","enum":["no-brreg.v1"]},"organisasjonsnummer":{"type":"string","pattern":"^\\d{9}$"},"mva_number":{"type":"string","minLength":1,"maxLength":160},"foretaksregisteret":{"type":"boolean"},"organisasjonsform":{"type":"string","minLength":1,"maxLength":160},"forretningskommune":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["GR"]},"schema_version":{"type":"string","enum":["gr-gemi.v1"]},"gemi_number":{"type":"string","minLength":1,"maxLength":160},"afm":{"type":"string","pattern":"^\\d{9}$"},"vat_number":{"type":"string","minLength":1,"maxLength":160},"doy":{"type":"string","minLength":1,"maxLength":2000},"legal_form":{"type":"string","minLength":1,"maxLength":2000},"chamber":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["HU"]},"schema_version":{"type":"string","enum":["hu-cegjegyzek.v1"]},"cegjegyzekszam":{"type":"string","minLength":1,"maxLength":160},"adoszam":{"type":"string","minLength":1,"maxLength":160},"vat_number":{"type":"string","minLength":1,"maxLength":160},"cegbirosag":{"type":"string","minLength":1,"maxLength":2000},"tevekenyseg":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["BG"]},"schema_version":{"type":"string","enum":["bg-trryulnc.v1"]},"eik":{"type":"string","pattern":"^\\d{9,13}$"},"vat_number":{"type":"string","minLength":1,"maxLength":160},"legal_form":{"type":"string","minLength":1,"maxLength":2000},"seat":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["FI"]},"schema_version":{"type":"string","enum":["fi-ytj.v1"]},"y_tunnus":{"type":"string","minLength":1,"maxLength":160},"vat_number":{"type":"string","minLength":1,"maxLength":160},"kotipaikka":{"type":"string","minLength":1,"maxLength":2000},"yritysmuoto":{"type":"string","minLength":1,"maxLength":2000},"toimiala_code":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["SK"]},"schema_version":{"type":"string","enum":["sk-rpo.v1"]},"ico":{"type":"string","pattern":"^\\d{8}$"},"dic":{"type":"string","pattern":"^\\d{10}$"},"ic_dph":{"type":"string","minLength":1,"maxLength":160},"oddiel_vlozka":{"type":"string","minLength":1,"maxLength":2000},"registrovy_sud":{"type":"string","minLength":1,"maxLength":2000},"pravna_forma":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["HR"]},"schema_version":{"type":"string","enum":["hr-sudski-registar.v1"]},"oib":{"type":"string","pattern":"^\\d{11}$"},"mbs":{"type":"string","pattern":"^\\d{8,9}$"},"vat_number":{"type":"string","minLength":1,"maxLength":160},"trg_sud":{"type":"string","minLength":1,"maxLength":2000},"temeljni_kapital":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["LT"]},"schema_version":{"type":"string","enum":["lt-jar.v1"]},"imones_kodas":{"type":"string","pattern":"^\\d{9}$"},"pvm_kodas":{"type":"string","minLength":1,"maxLength":160},"teisine_forma":{"type":"string","minLength":1,"maxLength":2000},"savivaldybe":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["SI"]},"schema_version":{"type":"string","enum":["si-ajpes.v1"]},"maticna_stevilka":{"type":"string","pattern":"^(?:\\d{7}|\\d{10})$"},"davcna_stevilka":{"type":"string","pattern":"^\\d{8}$"},"id_za_ddv":{"type":"string","minLength":1,"maxLength":160},"srg_vpis":{"type":"string","minLength":1,"maxLength":2000},"skd_code":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["LV"]},"schema_version":{"type":"string","enum":["lv-ur.v1"]},"registracijas_numurs":{"type":"string","pattern":"^\\d{11}$"},"pvn_numurs":{"type":"string","minLength":1,"maxLength":160},"tiesiska_forma":{"type":"string","minLength":1,"maxLength":2000},"sepa_id":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["EE"]},"schema_version":{"type":"string","enum":["ee-ariregister.v1"]},"registrikood":{"type":"string","pattern":"^\\d{8}$"},"kmkr_number":{"type":"string","minLength":1,"maxLength":160},"oiguslik_vorm":{"type":"string","minLength":1,"maxLength":2000},"emtak_code":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["CY"]},"schema_version":{"type":"string","enum":["cy-drcor.v1"]},"he_number":{"type":"string","minLength":1,"maxLength":160},"tic":{"type":"string","minLength":1,"maxLength":160},"vat_number":{"type":"string","minLength":1,"maxLength":160},"company_type":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["LU"]},"schema_version":{"type":"string","enum":["lu-lbr.v1"]},"rcs_number":{"type":"string","minLength":1,"maxLength":160},"matricule":{"type":"string","minLength":1,"maxLength":160},"tva_number":{"type":"string","minLength":1,"maxLength":160},"autorisation_etablissement":{"type":"string","minLength":1,"maxLength":160},"forme_juridique":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["MT"]},"schema_version":{"type":"string","enum":["mt-mbr.v1"]},"c_number":{"type":"string","minLength":1,"maxLength":160},"vat_number":{"type":"string","minLength":1,"maxLength":160},"company_type":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["IS"]},"schema_version":{"type":"string","enum":["is-skatturinn.v1"]},"kennitala":{"type":"string","pattern":"^\\d{10}$"},"vsk_number":{"type":"string","minLength":1,"maxLength":160},"rekstrarform":{"type":"string","minLength":1,"maxLength":2000},"isat_code":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["XI"]},"schema_version":{"type":"string","enum":["xi-companies-house.v1"]},"company_number":{"type":"string","minLength":1,"maxLength":160},"vat_number":{"type":"string","minLength":1,"maxLength":160},"company_type":{"type":"string","minLength":1,"maxLength":160},"jurisdiction_region":{"type":"string","minLength":1,"maxLength":2000},"sic_codes":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"minItems":1,"maxItems":10}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["GE"]},"schema_version":{"type":"string","enum":["ge-napr.v1"]},"identification_code":{"type":"string","pattern":"^\\d{9}$"},"napr_legal_code_id":{"type":"string","minLength":1,"maxLength":160},"stat_id":{"type":"string","minLength":1,"maxLength":160},"legal_form_abbr":{"type":"string","minLength":1,"maxLength":2000},"enterprise_size":{"type":"string","minLength":1,"maxLength":2000},"ownership_type":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["RS"]},"schema_version":{"type":"string","enum":["rs-apr.v1"]},"maticni_broj":{"type":"string","pattern":"^\\d{8}$"},"pib":{"type":"string","pattern":"^[1-9]\\d{8}$"},"pdv_number":{"type":"string","minLength":1,"maxLength":160},"pravna_forma":{"type":"string","minLength":1,"maxLength":2000},"status_registracije":{"type":"string","minLength":1,"maxLength":2000},"sifra_delatnosti":{"type":"string","minLength":1,"maxLength":160},"sifra_opstine":{"type":"string","minLength":1,"maxLength":160},"naziv_opstine":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["AL"]},"schema_version":{"type":"string","enum":["al-qkb.v1"]},"nipt":{"type":"string","pattern":"^[A-Z]\\d{8}[A-Z]$"},"forma_ligjore":{"type":"string","minLength":1,"maxLength":2000},"statusi":{"type":"string","minLength":1,"maxLength":2000},"qyteti":{"type":"string","minLength":1,"maxLength":2000},"kapitali":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["UA"]},"schema_version":{"type":"string","enum":["ua-edr.v1"]},"edrpou":{"type":"string","pattern":"^\\d{8}$"},"ipn_pdv":{"type":"string","pattern":"^\\d{10,12}$"},"kved_code":{"type":"string","minLength":1,"maxLength":160},"opf":{"type":"string","minLength":1,"maxLength":2000},"stan":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["TR"]},"schema_version":{"type":"string","enum":["tr-mersis.v1"]},"mersis_no":{"type":"string","pattern":"^\\d{16}$"},"vkn":{"type":"string","pattern":"^\\d{10}$"},"ticaret_sicil_no":{"type":"string","minLength":1,"maxLength":160},"ticaret_sicil_mudurlugu":{"type":"string","minLength":1,"maxLength":2000},"vergi_dairesi":{"type":"string","minLength":1,"maxLength":2000},"kep_address":{"type":"string","minLength":1,"maxLength":160},"sermaye":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version"],"additionalProperties":false}]},"DisclosurePublicCompanyIdentifier":{"type":"object","properties":{"type":{"type":"string","enum":["registry_id","domestic_tax_id","vat_id","lei","establishment_id","euid","statistical_id","economic_operator_id"]},"value":{"type":"string","minLength":1,"maxLength":8192},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"issuer":{"type":"null"},"register":{"type":["string","null"],"maxLength":8192},"scheme":{"type":"string","minLength":1,"maxLength":160},"role":{"type":"string","enum":["business_register","establishment","domestic_tax","vat","lei","euid","statistical","economic_operator"]},"evidence_refs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"state":{"type":"string","enum":["authority_confirmed","source_attributed","company_claimed","corroborated","partial_correlation","synthetic","discovered","conflicting","derived_candidate"]},"basis":{"type":"string","enum":["company_published","network_publication","authority_observed","sourced_association","derived_rule","synthetic"]},"observed_at":{"type":"string","format":"date-time"},"source_record_updated_at":{"oneOf":[{"type":"string","format":"date"},{"type":"string","format":"date-time"},{"type":"null"}]},"assessment":{"type":"object","properties":{"publication":{"type":"string","enum":["found"]},"association":{"type":"string","enum":["same_entity","conflicting","unresolved"]},"issuer_verification":{"type":"string","enum":["unsupported"]},"location_scope":{"type":"string","enum":["unknown","headquarters","branch","site"]}},"required":["publication","association","issuer_verification","location_scope"],"additionalProperties":false}},"required":["type","value","jurisdiction","evidence_refs"],"additionalProperties":false},"DisclosurePublicNationalVat":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"status":{"type":"string","enum":["registered","not_registered","unknown","unavailable","not_checked"]},"registered":{"type":["boolean","null"]},"registrationDate":{"type":["string","null"],"maxLength":8192},"deregistrationDate":{"type":["string","null"],"maxLength":8192},"relationship":{"type":"string","enum":["direct_registration","foreign_registration","vat_group_membership"]},"referenceDate":{"type":"string","format":"date"},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"source":{"oneOf":[{"$ref":"#/components/schemas/DisclosureGovernmentPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceNonOfficialPublicRegistry"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceCompanyPublication"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSearchDiscovery"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceUnclassifiedPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSynthetic"},{"type":"null"}]}},"additionalProperties":false},"DisclosurePublicVatCandidate":{"type":"object","properties":{"value":{"type":"string","maxLength":8192},"basis":{"type":"string","enum":["explicit_public_claim","government_association","derived_rule","synthetic"]},"viesStatus":{"type":"string","enum":["valid","invalid","unavailable","not_requested","not_applicable"]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["value","basis"],"additionalProperties":false},"DisclosurePublicDerivedVatCandidateOutcome":{"type":"object","properties":{"code":{"type":"string","enum":["derived_vat_candidate_unconfirmed"]},"message":{"type":"string","enum":["The domestic tax identifier is confirmed, but VIES did not confirm the VAT number derived from it. This can mean the number is not activated for cross-border use, is not a VAT registration, or is not yet updated in VIES; this result does not show which."]},"action":{"type":"string","enum":["request_vat_number_from_customer"]},"checkedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"jurisdictionNote":{"$ref":"#/components/schemas/DisclosurePublicBulkReviewJurisdictionNote"}},"required":["code","message","action","checkedAt","evidenceRefs"],"additionalProperties":false},"DisclosurePublicBulkReviewJurisdictionNote":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["bulk-review-jurisdiction-note.v1"]},"code":{"type":"string","enum":["es_roi_enrolment"]},"statement":{"type":"string","enum":["VAT Tools summary of a general Spanish Tax Agency rule: a business established in mainland Spain or the Balearic Islands needs entry in the register of intra-Community operators (ROI) to use a Spanish VAT number for the intra-Community operations the Agency lists. It does not state this company's status."]},"ruleReferences":{"type":"object","properties":{"schema_version":{"type":"string","enum":["workflow-territory-rule-references.v1"]},"qualification_scope":{"type":"string","enum":["source_reference_only"]},"legal_applicability":{"type":"string","enum":["not_qualified_by_this_fragment"]},"references":{"type":"array","items":{"type":"object","properties":{"use_token":{"type":"string","enum":["derived_geography_rule_reference.v1","derived_legal_rule_reference.v1"]},"content_kind":{"type":"string","enum":["exact_resource_citation"]},"source":{"type":"object","properties":{"kind":{"type":"string","enum":["government"]},"publisher":{"type":"string","minLength":1,"maxLength":240},"service":{"type":"string","minLength":1,"maxLength":240},"jurisdiction":{"type":"string","enum":["ES","EU","DE","CH","IT","FI","FR"]},"evidence_role":{"type":"string","enum":["map_rule","legal_rule"]},"url":{"type":"string","format":"uri"},"notices":{"type":"array","items":{"type":"string","minLength":1,"maxLength":2000},"minItems":1,"maxItems":16}},"required":["kind","publisher","service","jurisdiction","evidence_role","url","notices"],"additionalProperties":false},"document":{"type":"object","properties":{"captured_at":{"type":"string","format":"date-time"},"source_published_at":{"type":["string","null"],"format":"date"},"source_updated_at":{"type":["string","null"],"format":"date"},"revision_kind":{"type":"string","enum":["undated_reference","selected_consolidated_publication","original_publication","updated_guidance_page"]}},"required":["captured_at","source_published_at","source_updated_at","revision_kind"],"additionalProperties":false}},"required":["use_token","content_kind","source","document"],"additionalProperties":false},"minItems":1,"maxItems":20}},"required":["schema_version","qualification_scope","legal_applicability","references"],"additionalProperties":false}},"required":["schemaVersion","code","statement","ruleReferences"],"additionalProperties":false},"DisclosurePublicFieldProvenance":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"state":{"type":"string","enum":["authority_confirmed","source_attributed","company_claimed","partial_correlation","synthetic","discovered","conflicting","derived_candidate"]},"observed_at":{"type":["string","null"],"format":"date-time"},"evidence_refs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["field","state","observed_at","evidence_refs"],"additionalProperties":false},"DisclosurePublicMissingField":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/DisclosurePublicEvidenceField"},"reason":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["field","reason"],"additionalProperties":false},"DisclosurePublicCompanyVerificationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_verification"]},"outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unavailable","unsupported","valid","invalid"]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"company":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompany"},"maxItems":100},"totalResults":{"type":["integer","null"],"minimum":0},"truncated":{"type":"boolean"}},"required":["kind","outcome"],"additionalProperties":false},"DisclosurePublicVatDiscoveryResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_discovery"]},"outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unavailable","unsupported","valid","invalid"]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"company":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompany"},"maxItems":100},"totalResults":{"type":["integer","null"],"minimum":0},"truncated":{"type":"boolean"},"associations":{"type":"array","items":{"type":"object","properties":{"vatNumber":{"type":"string","maxLength":160},"registryId":{"type":"string","maxLength":160},"basis":{"type":"string","enum":["government_dataset","government_registry","derived_rule","partial_correlation","synthetic"]},"relationship":{"type":"string","enum":["direct_registration","foreign_registration","vat_group_membership"]},"validityDate":{"type":["string","null"]},"issuedDate":{"type":["string","null"]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["vatNumber","registryId","basis","evidenceRefs"],"additionalProperties":false},"maxItems":20},"validations":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicVatValidationResult"},"maxItems":20},"derivedVatCandidate":{"$ref":"#/components/schemas/DisclosurePublicDerivedVatCandidateOutcome"}},"required":["kind","outcome","associations","validations"],"additionalProperties":false},"DisclosurePublicResolutionDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"operation":{"$ref":"#/components/schemas/DisclosurePublicOperation"},"subject":{"$ref":"#/components/schemas/DisclosurePublicDeliverySubject"},"usage":{"$ref":"#/components/schemas/DisclosurePublicUsage"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"staleEvidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"claims":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicClaim"},"maxItems":1000},"relationships":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicRelationship"},"maxItems":1000},"conflicts":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicConflict"},"maxItems":100},"issues":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicIssue"},"maxItems":100},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100},"result":{"type":"object","properties":{"kind":{"type":"string","enum":["company_resolution"]},"outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unavailable","unsupported","valid","invalid"]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"company":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompany"},"maxItems":100},"totalResults":{"type":["integer","null"],"minimum":0},"truncated":{"type":"boolean"},"identityConfirmed":{"type":"boolean"},"sourceTrail":{"type":"array","items":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"completion":{"type":"string","enum":["complete","incomplete","skipped"]},"attemptedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"producedEvidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30}},"required":["source","completion","attemptedAt","completedAt","producedEvidenceRefs","reasons"],"additionalProperties":false},"maxItems":100}},"required":["kind","outcome"],"additionalProperties":false}},"required":["schemaVersion","disclosurePolicyVersion","operation","subject","usage","evidence","fieldTrust","result"],"additionalProperties":false},"DisclosurePublicWebCompanyDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"operation":{"$ref":"#/components/schemas/DisclosurePublicOperation"},"subject":{"$ref":"#/components/schemas/DisclosurePublicDeliverySubject"},"usage":{"$ref":"#/components/schemas/DisclosurePublicUsage"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"staleEvidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"claims":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicClaim"},"maxItems":1000},"relationships":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicRelationship"},"maxItems":1000},"conflicts":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicConflict"},"maxItems":100},"issues":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicIssue"},"maxItems":100},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100},"result":{"type":"object","properties":{"outcome":{"type":"string","enum":["resolved","candidates_found","found","not_found","unsupported","source_unavailable","partial","conflicting"]},"kind":{"type":"string","enum":["company_web_verification"]},"reconciledProfile":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]},"company":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompany"},"maxItems":100},"totalCandidates":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"reconciliationBasis":{"type":"object","properties":{"selectedVatBasis":{"type":"string","enum":["supplied_identifier","registry_identifier","vies_name_match","first_valid_candidate","explicit_source_association","none"]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"maxItems":100}},"required":["selectedVatBasis","sources"],"additionalProperties":false}},"required":["outcome","candidates"],"additionalProperties":false}},"required":["schemaVersion","disclosurePolicyVersion","operation","subject","usage","evidence","fieldTrust","result"],"additionalProperties":false},"DisclosurePublicIdentifierChecksDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"operation":{"$ref":"#/components/schemas/DisclosurePublicOperation"},"subject":{"type":"object","properties":{"identifiers":{"$ref":"#/components/schemas/DisclosurePublicIdentifierInput"}},"required":["identifiers"],"additionalProperties":false},"result":{"type":"object","properties":{"kind":{"type":"string","enum":["identifier_checks"]},"outcome":{"type":"string","enum":["complete","partial","source_unavailable"]},"checks":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicIdentifierCheck"},"minItems":1,"maxItems":6},"reconciliation":{"type":"string","enum":["consistent","conflict","unresolved"]},"comparisons":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["legal_name","jurisdiction","identifier_association"]},"identifier_type":{"type":"string","enum":["lei","eori","peppol","national","euid","duns"]},"expected":{"type":["string","null"],"maxLength":8192},"observed":{"type":["string","null"],"maxLength":8192},"outcome":{"type":"string","enum":["match","mismatch","unresolved"]},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30}},"required":["field","identifier_type","expected","observed","outcome"],"additionalProperties":false},"maxItems":40}},"required":["kind","outcome","checks","reconciliation","comparisons"],"additionalProperties":false},"usage":{"$ref":"#/components/schemas/DisclosurePublicUsage"},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","operation","subject","result","usage","fieldTrust"],"additionalProperties":false},"DisclosurePublicIdentifierCheck":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicIdentifierCheckLei"},{"$ref":"#/components/schemas/DisclosurePublicIdentifierCheckEori"},{"$ref":"#/components/schemas/DisclosurePublicIdentifierCheckPeppol"},{"$ref":"#/components/schemas/DisclosurePublicIdentifierCheckNational"},{"$ref":"#/components/schemas/DisclosurePublicIdentifierCheckEuid"},{"$ref":"#/components/schemas/DisclosurePublicIdentifierCheckDuns"}],"discriminator":{"propertyName":"type","mapping":{"lei":"#/components/schemas/DisclosurePublicIdentifierCheckLei","eori":"#/components/schemas/DisclosurePublicIdentifierCheckEori","peppol":"#/components/schemas/DisclosurePublicIdentifierCheckPeppol","national":"#/components/schemas/DisclosurePublicIdentifierCheckNational","euid":"#/components/schemas/DisclosurePublicIdentifierCheckEuid","duns":"#/components/schemas/DisclosurePublicIdentifierCheckDuns"}}},"DisclosurePublicIdentifierCheckLei":{"type":"object","properties":{"identifier":{"type":"string","maxLength":8192},"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30},"type":{"type":"string","enum":["lei"]},"status":{"type":"string","enum":["found","not_found","out_of_scope","unavailable"]},"observed_jurisdiction":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"profile":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]}},"required":["identifier","source","type","status","observed_jurisdiction","profile"],"additionalProperties":false},"DisclosurePublicIdentifierCheckEori":{"type":"object","properties":{"identifier":{"type":"string","maxLength":8192},"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30},"type":{"type":"string","enum":["eori"]},"status":{"type":"string","enum":["valid","invalid","unavailable"]},"issuer_country":{"type":"string","pattern":"^[A-Z]{2}$"},"holder_name":{"type":["string","null"],"maxLength":8192},"holder_address":{"type":["string","null"],"maxLength":8192}},"required":["identifier","source","type","status","issuer_country","holder_name","holder_address"],"additionalProperties":false},"DisclosurePublicIdentifierCheckPeppol":{"type":"object","properties":{"identifier":{"type":"string","maxLength":8192},"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30},"type":{"type":"string","enum":["peppol"]},"status":{"type":"string","enum":["published","not_found","unavailable"]},"publication":{"type":"string","enum":["found","not_found","unknown"]},"trust":{"type":"string","enum":["verified","unverified"]},"smp_url":{"type":"null"},"smp_source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicPeppolCapability"},"maxItems":200},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30}},"required":["identifier","source","type","status","capabilities"],"additionalProperties":false},"DisclosurePublicPeppolCapability":{"type":"object","properties":{"document_type_id":{"type":"string","maxLength":8192},"process_id":{"type":"string","maxLength":8192},"transport_profile":{"type":"string","maxLength":8192},"activation_date":{"type":["string","null"],"maxLength":8192},"expiration_date":{"type":["string","null"],"maxLength":8192},"endpoint_url":{"type":"null"},"endpoint_source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"}},"required":["document_type_id","process_id","transport_profile"],"additionalProperties":false},"DisclosurePublicIdentifierCheckNational":{"type":"object","properties":{"identifier":{"type":"string","maxLength":8192},"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30},"type":{"type":"string","enum":["national"]},"scheme":{"type":"string","enum":["no.orgnr","fr.siren","fr.siret","gb.crn","ch.uid","de.hrb","es.nif","it.cf","nl.kvk","be.kbo","at.fn","pl.krs","pl.nip","cz.ico","sk.ico","se.orgnr","dk.cvr","fi.ytunnus","ie.cro","pt.nipc","ro.cui","gr.afm","gr.gemi","hu.adoszam","bg.eik","hr.oib","si.maticna","lt.jar","lv.regnr","ee.registrikood","lu.rcs","cy.he","mt.mbr","xi.crn","is.kennitala","ge.id","rs.mb","rs.pib","al.nipt","ua.edrpou","tr.mersis","tr.vkn"]},"status":{"type":"string","enum":["found","not_found","out_of_scope","unavailable"]},"profile":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicNationalIdentifierProfile"},{"type":"null"}]}},"required":["identifier","source","type","scheme","status","profile"],"additionalProperties":false},"DisclosurePublicNationalIdentifierProfile":{"type":"object","properties":{"legal_name":{"type":"string","maxLength":8192},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"registration_scheme":{"type":"string","enum":["no.orgnr","fr.siren","fr.siret","gb.crn","ch.uid","de.hrb","es.nif","it.cf","nl.kvk","be.kbo","at.fn","pl.krs","pl.nip","cz.ico","sk.ico","se.orgnr","dk.cvr","fi.ytunnus","ie.cro","pt.nipc","ro.cui","gr.afm","gr.gemi","hu.adoszam","bg.eik","hr.oib","si.maticna","lt.jar","lv.regnr","ee.registrikood","lu.rcs","cy.he","mt.mbr","xi.crn","is.kennitala","ge.id","rs.mb","rs.pib","al.nipt","ua.edrpou","tr.mersis","tr.vkn"]},"registration_id":{"type":"string","maxLength":8192},"establishment_id":{"type":["string","null"],"maxLength":8192},"legal_status":{"type":["string","null"],"maxLength":8192},"registered_address":{"type":["string","null"],"maxLength":8192},"registered_website":{"type":"string","format":"uri"},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompanyIdentifier"},"maxItems":100},"vat_registration":{"type":"object","properties":{"status":{"type":"string","enum":["registered","not_registered","unavailable","not_checked"]},"identifier":{"type":["string","null"],"maxLength":8192},"association":{"type":"string","enum":["same_entity","vat_group","source_link","unresolved"]},"source":{"oneOf":[{"$ref":"#/components/schemas/DisclosureGovernmentPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceNonOfficialPublicRegistry"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceCompanyPublication"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSearchDiscovery"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceUnclassifiedPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSynthetic"},{"type":"null"}]}},"required":["status","identifier","association","source"],"additionalProperties":false}},"required":["legal_name","jurisdiction","registration_scheme","registration_id","establishment_id","legal_status","registered_address","identifiers","vat_registration"],"additionalProperties":false},"DisclosurePublicIdentifierCheckEuid":{"type":"object","properties":{"identifier":{"type":"string","maxLength":8192},"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30},"type":{"type":"string","enum":["euid"]},"status":{"type":"string","enum":["found","not_found","not_disclosed","unsupported","unavailable"]},"profile":{"type":["object","null"],"properties":{"registry_id":{"type":"string","maxLength":8192},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"legal_name":{"type":["string","null"],"maxLength":8192},"legal_form":{"type":["string","null"],"maxLength":8192},"standing":{"type":"string","enum":["active","inactive","unknown"]},"entity_scope":{"type":"string","enum":["legal_entity","branch","unknown"]},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompanyIdentifier"},"maxItems":100}},"required":["registry_id","jurisdiction","legal_name","legal_form","standing","entity_scope","identifiers"],"additionalProperties":false}},"required":["identifier","source","type","status","profile"],"additionalProperties":false},"DisclosurePublicIdentifierCheckDuns":{"type":"object","properties":{"identifier":{"type":"string","maxLength":8192},"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30},"type":{"type":"string","enum":["duns"]},"status":{"type":"string","enum":["published","not_found","unsupported","unavailable"]},"publication":{"type":"string","enum":["found","not_found","unknown"]},"association":{"type":"string","enum":["same_entity","conflicting","unresolved"]},"issuer_verification":{"type":"string","enum":["unsupported"]},"location_scope":{"type":"string","enum":["unknown","headquarters","branch","site"]},"published_subject":{"type":["object","null"],"properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"registration_scheme":{"type":"string","enum":["no.orgnr","fr.siren","fr.siret","gb.crn","ch.uid","de.hrb","es.nif","it.cf","nl.kvk","be.kbo","at.fn","pl.krs","pl.nip","cz.ico","sk.ico","se.orgnr","dk.cvr","fi.ytunnus","ie.cro","pt.nipc","ro.cui","gr.afm","gr.gemi","hu.adoszam","bg.eik","hr.oib","si.maticna","lt.jar","lv.regnr","ee.registrikood","lu.rcs","cy.he","mt.mbr","xi.crn","is.kennitala","ge.id","rs.mb","rs.pib","al.nipt","ua.edrpou","tr.mersis","tr.vkn"]},"registration_id":{"type":"string","maxLength":8192},"legal_name":{"type":"string","maxLength":8192}},"required":["jurisdiction","registration_scheme","registration_id","legal_name"],"additionalProperties":false},"published_identifier":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompanyIdentifier"},{"type":"null"}]},"profile":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicNationalIdentifierProfile"},{"type":"null"}]},"identity_source":{"oneOf":[{"$ref":"#/components/schemas/DisclosureGovernmentPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceNonOfficialPublicRegistry"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceCompanyPublication"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSearchDiscovery"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceUnclassifiedPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSynthetic"},{"type":"null"}]}},"required":["identifier","source","type","status","publication","association","issuer_verification","location_scope"],"additionalProperties":false},"DisclosurePublicLegacyCompanyDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"id":{"type":"string","minLength":1,"maxLength":160},"input":{"$ref":"#/components/schemas/DisclosurePublicDeliveryInput"},"observation":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","maxLength":2000},"registryId":{"type":"string","maxLength":160},"register":{"type":"string","maxLength":160},"mode":{"type":"string","enum":["live","sandbox"]},"outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unavailable","unsupported","valid","invalid"]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompany"},"maxItems":100},"company":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]},"totalResults":{"type":["integer","null"],"minimum":0},"truncated":{"type":"boolean"},"associations":{"type":"array","items":{"type":"object","properties":{"vatNumber":{"type":"string","maxLength":160},"registryId":{"type":"string","maxLength":160},"basis":{"type":"string","enum":["government_dataset","government_registry","derived_rule","partial_correlation","synthetic"]},"relationship":{"type":"string","enum":["direct_registration","foreign_registration","vat_group_membership"]},"validityDate":{"type":["string","null"]},"issuedDate":{"type":["string","null"]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["vatNumber","registryId","basis","evidenceRefs"],"additionalProperties":false},"maxItems":20},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"error":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicIssue"},{"type":"null"}]}},"required":["outcome","evidence"],"additionalProperties":false},"company":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]},"claims":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicClaim"},"maxItems":100},"validations":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicVatValidationResult"},"maxItems":20},"createdAt":{"type":"string","format":"date-time"},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","id","input","observation","createdAt","fieldTrust"],"additionalProperties":false},"WebhookEventEnvelopeBulkJobCompletedV1":{"type":"object","properties":{"id":{"type":"string","pattern":"^evt_[0-9a-f]{32}$"},"type":{"type":"string","enum":["bulk_job.completed"]},"timestamp":{"type":"string","format":"date-time"},"data":{"$ref":"#/components/schemas/BulkJobCompletedDataV1"}},"required":["id","type","timestamp","data"],"additionalProperties":false},"BulkJobCompletedDataV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["webhook-events-v1"]},"job":{"$ref":"#/components/schemas/DisclosurePublicBulkJobDelivery"},"rowsPath":{"type":"string","maxLength":256}},"required":["schemaVersion","job","rowsPath"],"additionalProperties":false},"DisclosurePublicBulkJobDelivery":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","minLength":1},"environment":{"type":"string","enum":["sandbox","live"]},"kind":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"name":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"status":{"type":"string","enum":["draft","queued","running","paused","cancelling","cancelled","completed","completed_with_issues"]},"counts":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":10000},"eligible":{"type":"integer","minimum":0,"maximum":10000},"invalid":{"type":"integer","minimum":0,"maximum":10000},"duplicate":{"type":"integer","minimum":0,"maximum":10000},"pending":{"type":"integer","minimum":0,"maximum":10000},"admitted":{"type":"integer","minimum":0,"maximum":10000},"completed":{"type":"integer","minimum":0,"maximum":10000},"failed":{"type":"integer","minimum":0,"maximum":10000},"interrupted":{"type":"integer","minimum":0,"maximum":10000},"cancelled":{"type":"integer","minimum":0,"maximum":10000},"unavailable":{"type":"integer","minimum":0,"maximum":10000}},"required":["total","eligible","invalid","duplicate","pending","admitted","completed","failed","interrupted","cancelled","unavailable"],"additionalProperties":false},"pauseReason":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["QUOTA_EXCEEDED","TRIAL_QUOTA_EXCEEDED","TRIAL_EXPIRED","LIVE_PLAN_INACTIVE","AUTHORIZATION_REQUIRED","DEPENDENCY_UNAVAILABLE","PLAN_CAPACITY_EXCEEDED"]},"message":{"type":"string","enum":["Processing is paused. Review the pause code before resuming."]},"retryAt":{"type":["string","null"],"format":"date-time"}},"required":["code","message","retryAt"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"},"cancelRequestedAt":{"type":["string","null"],"format":"date-time"},"pollAfterMs":{"type":"integer","minimum":1000,"maximum":30000}},"required":["id","organizationId","environment","kind","name","status","counts","pauseReason","createdAt","updatedAt","startedAt","finishedAt","cancelRequestedAt","pollAfterMs"],"additionalProperties":false},"WebhookEventEnvelopeMonitorChangeObservedV1":{"type":"object","properties":{"id":{"type":"string","pattern":"^evt_[0-9a-f]{32}$"},"type":{"type":"string","enum":["monitor.change_observed"]},"timestamp":{"type":"string","format":"date-time"},"data":{"$ref":"#/components/schemas/MonitorChangeObservedDataV1"}},"required":["id","type","timestamp","data"],"additionalProperties":false},"MonitorChangeObservedDataV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monitor-events-v1"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"environment":{"type":"string","enum":["live","sandbox"]},"monitorId":{"type":"string","format":"uuid"},"change":{"$ref":"#/components/schemas/MonitorObservedChangeV1"}},"required":["schemaVersion","disclosurePolicyVersion","environment","monitorId","change"],"additionalProperties":false},"MonitorObservedChangeV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monitor-changes-v1"]},"id":{"type":"string","format":"uuid"},"monitorId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","minLength":1,"maxLength":128},"environment":{"type":"string","enum":["live","sandbox"]},"subject":{"$ref":"#/components/schemas/MonitorSubjectV1"},"counterpartyVatId":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"fact":{"$ref":"#/components/schemas/MonitorWatchedFactV1"},"before":{"$ref":"#/components/schemas/MonitorFactObservationV1"},"after":{"$ref":"#/components/schemas/MonitorFactObservationV1"},"detectedAt":{"type":"string","format":"date-time"},"notices":{"type":"array","items":{"type":"string","enum":["Validity confirms registration only and does not show that the number belongs to your customer.","An invalid result means the authority did not confirm the number for intra-EU trade on that date. In some Member States a business can hold a domestic VAT registration without one."]},"maxItems":2},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]}},"required":["schemaVersion","id","monitorId","organizationId","environment","subject","counterpartyVatId","fact","before","after","detectedAt","notices","disclosurePolicyVersion"],"additionalProperties":false},"MonitorFactObservationV1":{"type":"object","properties":{"fact":{"$ref":"#/components/schemas/MonitorWatchedFactV1"},"outcome":{"type":"string","enum":["definitive","not_observed"]},"value":{"$ref":"#/components/schemas/MonitorFactValueV1"},"observedAt":{"type":"string","format":"date-time"},"runId":{"type":"string","format":"uuid"},"notObservedReason":{"$ref":"#/components/schemas/MonitorNotObservedReasonV1"},"source":{"$ref":"#/components/schemas/MonitorFactSourceV1"}},"required":["fact","outcome","value","observedAt","runId","source"],"additionalProperties":false},"MonitorFactValueV1":{"oneOf":[{"$ref":"#/components/schemas/MonitorVatStatusValueV1"},{"$ref":"#/components/schemas/MonitorTextValueV1"},{"$ref":"#/components/schemas/MonitorAddressValueV1"},{"$ref":"#/components/schemas/MonitorLegalStatusValueV1"},{"$ref":"#/components/schemas/MonitorInsolvencyValueV1"},{"$ref":"#/components/schemas/MonitorLegalFormValueV1"},{"type":"null"}]},"MonitorVatStatusValueV1":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_status"]},"status":{"type":"string","enum":["valid","invalid"]}},"required":["kind","status"],"additionalProperties":false},"MonitorTextValueV1":{"type":"object","properties":{"kind":{"type":"string","enum":["text"]},"text":{"type":"string","minLength":1,"maxLength":2000}},"required":["kind","text"],"additionalProperties":false},"MonitorAddressValueV1":{"type":"object","properties":{"kind":{"type":"string","enum":["address"]},"lines":{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"maxItems":10},"postalCode":{"type":["string","null"],"minLength":1,"maxLength":2000},"locality":{"type":["string","null"],"minLength":1,"maxLength":2000},"region":{"type":["string","null"],"minLength":1,"maxLength":2000},"countryCode":{"type":["string","null"],"pattern":"^[A-Z]{2}$"}},"required":["kind","lines","postalCode","locality","region","countryCode"],"additionalProperties":false},"MonitorLegalStatusValueV1":{"type":"object","properties":{"kind":{"type":"string","enum":["legal_status"]},"status":{"type":"string","enum":["active","ceased"]},"nativeStatus":{"type":["string","null"],"minLength":1,"maxLength":2000}},"required":["kind","status","nativeStatus"],"additionalProperties":false},"MonitorInsolvencyValueV1":{"type":"object","properties":{"kind":{"type":"string","enum":["insolvency"]},"proceedings":{"type":"array","items":{"type":"string","enum":["bankruptcy","liquidation","compulsory_dissolution","administration","receivership","voluntary_arrangement","restructuring","safeguard","insolvency_proceedings"]}},"nativeCodes":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":32}},"required":["kind","proceedings","nativeCodes"],"additionalProperties":false},"MonitorLegalFormValueV1":{"type":"object","properties":{"kind":{"type":"string","enum":["legal_form"]},"scheme":{"type":["string","null"],"minLength":1,"maxLength":2000},"code":{"type":["string","null"],"minLength":1,"maxLength":2000},"label":{"type":["string","null"],"minLength":1,"maxLength":2000}},"required":["kind","scheme","code","label"],"additionalProperties":false},"MonitorFactSourceV1":{"oneOf":[{"$ref":"#/components/schemas/DisclosureGovernmentPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceNonOfficialPublicRegistry"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceCompanyPublication"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSearchDiscovery"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceUnclassifiedPublicSource"},{"$ref":"#/components/schemas/DisclosureAnonymousPublicSourceSynthetic"},{"type":"null"}]},"WebhookEventEnvelopeMonitorVisibilityRestoredV1":{"type":"object","properties":{"id":{"type":"string","pattern":"^evt_[0-9a-f]{32}$"},"type":{"type":"string","enum":["monitor.visibility_restored"]},"timestamp":{"type":"string","format":"date-time"},"data":{"$ref":"#/components/schemas/MonitorVisibilityRestoredDataV1"}},"required":["id","type","timestamp","data"],"additionalProperties":false},"MonitorVisibilityRestoredDataV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monitor-events-v1"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"environment":{"type":"string","enum":["live","sandbox"]},"organizationId":{"type":"string","minLength":1,"maxLength":128},"monitorId":{"type":"string","format":"uuid"},"subject":{"$ref":"#/components/schemas/MonitorSubjectV1"},"counterpartyVatId":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"cannotSeeSince":{"type":"string","format":"date-time"},"restoredAt":{"type":"string","format":"date-time"},"restoringRunId":{"type":"string","format":"uuid"}},"required":["schemaVersion","disclosurePolicyVersion","environment","organizationId","monitorId","subject","counterpartyVatId","cannotSeeSince","restoredAt","restoringRunId"],"additionalProperties":false},"WebhookEventEnvelopeWebhookTestV1":{"type":"object","properties":{"id":{"type":"string","pattern":"^evt_[0-9a-f]{32}$"},"type":{"type":"string","enum":["webhook.test"]},"timestamp":{"type":"string","format":"date-time"},"data":{"$ref":"#/components/schemas/WebhookTestDataV1"}},"required":["id","type","timestamp","data"],"additionalProperties":false},"WebhookTestDataV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["webhook-events-v1"]},"endpointId":{"type":"string","format":"uuid"},"environment":{"type":"string","enum":["live","sandbox"]},"message":{"type":"string","enum":["This is a test event from VAT Tools. It carries no customer data."]}},"required":["schemaVersion","endpointId","environment","message"],"additionalProperties":false},"DisclosurePublicErrorBody400":{"type":"object","properties":{"error":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable"},{"$ref":"#/components/schemas/DisclosurePublicErrorInvalidRequest"},{"$ref":"#/components/schemas/DisclosurePublicErrorInvalidIdempotencyKey"},{"$ref":"#/components/schemas/DisclosurePublicErrorInvalidJson"},{"$ref":"#/components/schemas/DisclosurePublicErrorInvalidInput"},{"$ref":"#/components/schemas/DisclosurePublicErrorReferencesNotSupported"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitorSubjectInvalid"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitorFactNotWatchable"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitorFactUnavailable"},{"$ref":"#/components/schemas/DisclosurePublicErrorWebhookUrlRejected"}],"discriminator":{"propertyName":"code","mapping":{"PUBLIC_DELIVERY_UNAVAILABLE":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable","INVALID_REQUEST":"#/components/schemas/DisclosurePublicErrorInvalidRequest","INVALID_IDEMPOTENCY_KEY":"#/components/schemas/DisclosurePublicErrorInvalidIdempotencyKey","INVALID_JSON":"#/components/schemas/DisclosurePublicErrorInvalidJson","INVALID_INPUT":"#/components/schemas/DisclosurePublicErrorInvalidInput","REFERENCES_NOT_SUPPORTED":"#/components/schemas/DisclosurePublicErrorReferencesNotSupported","MONITOR_SUBJECT_INVALID":"#/components/schemas/DisclosurePublicErrorMonitorSubjectInvalid","MONITOR_FACT_NOT_WATCHABLE":"#/components/schemas/DisclosurePublicErrorMonitorFactNotWatchable","MONITOR_FACT_UNAVAILABLE":"#/components/schemas/DisclosurePublicErrorMonitorFactUnavailable","WEBHOOK_URL_REJECTED":"#/components/schemas/DisclosurePublicErrorWebhookUrlRejected"}}}},"required":["error"],"additionalProperties":false},"DisclosurePublicErrorPublicDeliveryUnavailable":{"type":"object","properties":{"code":{"type":"string","enum":["PUBLIC_DELIVERY_UNAVAILABLE"]},"message":{"type":"string","enum":["Public delivery unavailable."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosureRequestId":{"type":"string","format":"uuid","description":"The id in the response's `x-request-id` header; quote it to support."},"DisclosurePublicErrorInvalidRequest":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST"]},"message":{"type":"string","enum":["Check the request fields and their limits."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorInvalidIdempotencyKey":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_IDEMPOTENCY_KEY"]},"message":{"type":"string","enum":["Use an idempotency key of 8–128 letters, digits, dots, underscores, colons or hyphens, starting with a letter or digit.","Idempotency-Key must contain 8–128 supported characters."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorInvalidJson":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_JSON"]},"message":{"type":"string","enum":["Send a valid JSON request body."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorInvalidInput":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_INPUT"]},"message":{"type":"string","enum":["Check the supplied details and try again.","Provide a two-letter country code and a VAT number (up to 32 characters).","The VAT number prefix does not match the selected country.","Use a single country prefix followed by the domestic VAT number.","Enter the VAT number after its country prefix.","Invalid requester VAT number.","The VAT number does not match the national format or check digit."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorReferencesNotSupported":{"type":"object","properties":{"code":{"type":"string","enum":["REFERENCES_NOT_SUPPORTED"]},"message":{"type":"string","enum":["Transaction references cannot be saved for this VAT number. Send the request without references."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorMonitorSubjectInvalid":{"type":"object","properties":{"code":{"type":"string","enum":["MONITOR_SUBJECT_INVALID"]},"message":{"type":"string","enum":["Check the monitored VAT identifier or registry identifier."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorMonitorFactNotWatchable":{"type":"object","properties":{"code":{"type":"string","enum":["MONITOR_FACT_NOT_WATCHABLE"]},"message":{"type":"string","enum":["One or more watched facts do not apply to this kind of subject."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorMonitorFactUnavailable":{"type":"object","properties":{"code":{"type":"string","enum":["MONITOR_FACT_UNAVAILABLE"]},"message":{"type":"string","enum":["One or more watched facts cannot be observed for this subject's country."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorWebhookUrlRejected":{"type":"object","properties":{"code":{"type":"string","enum":["WEBHOOK_URL_REJECTED"]},"message":{"type":"string","enum":["Use a public HTTPS URL without credentials or a fragment."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorBody401":{"type":"object","properties":{"error":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable"},{"$ref":"#/components/schemas/DisclosurePublicErrorUnauthorized"},{"$ref":"#/components/schemas/DisclosurePublicErrorPasskeyNotFound"},{"$ref":"#/components/schemas/DisclosurePublicErrorUserVerificationRequired"}],"discriminator":{"propertyName":"code","mapping":{"PUBLIC_DELIVERY_UNAVAILABLE":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable","UNAUTHORIZED":"#/components/schemas/DisclosurePublicErrorUnauthorized","PASSKEY_NOT_FOUND":"#/components/schemas/DisclosurePublicErrorPasskeyNotFound","USER_VERIFICATION_REQUIRED":"#/components/schemas/DisclosurePublicErrorUserVerificationRequired"}}}},"required":["error"],"additionalProperties":false},"DisclosurePublicErrorUnauthorized":{"type":"object","properties":{"code":{"type":"string","enum":["UNAUTHORIZED"]},"message":{"type":"string","enum":["A valid account session or API key is required."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorPasskeyNotFound":{"type":"object","properties":{"code":{"type":"string","enum":["PASSKEY_NOT_FOUND"]},"message":{"type":"string","enum":["Passkey not found"]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorUserVerificationRequired":{"type":"object","properties":{"code":{"type":"string","enum":["USER_VERIFICATION_REQUIRED"]},"message":{"type":"string","enum":["Unlock the passkey with your fingerprint, face or device PIN."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorBody403":{"type":"object","properties":{"error":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable"},{"$ref":"#/components/schemas/DisclosurePublicErrorScopeForbidden"},{"$ref":"#/components/schemas/DisclosurePublicErrorFreeOrganizationLimitReached"},{"$ref":"#/components/schemas/DisclosurePublicErrorTwoFactorRequired"},{"$ref":"#/components/schemas/DisclosurePublicErrorOwnerTwoFactorRequired"},{"$ref":"#/components/schemas/DisclosurePublicErrorStrongerTwoFactorRequired"},{"$ref":"#/components/schemas/DisclosurePublicErrorOwnerStrongTwoFactorRequired"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitoringNotInPlan"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitorCadenceNotInPlan"},{"$ref":"#/components/schemas/DisclosurePublicErrorWebhooksNotInPlan"}],"discriminator":{"propertyName":"code","mapping":{"PUBLIC_DELIVERY_UNAVAILABLE":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable","SCOPE_FORBIDDEN":"#/components/schemas/DisclosurePublicErrorScopeForbidden","FREE_ORGANIZATION_LIMIT_REACHED":"#/components/schemas/DisclosurePublicErrorFreeOrganizationLimitReached","TWO_FACTOR_REQUIRED":"#/components/schemas/DisclosurePublicErrorTwoFactorRequired","OWNER_TWO_FACTOR_REQUIRED":"#/components/schemas/DisclosurePublicErrorOwnerTwoFactorRequired","STRONGER_TWO_FACTOR_REQUIRED":"#/components/schemas/DisclosurePublicErrorStrongerTwoFactorRequired","OWNER_STRONG_TWO_FACTOR_REQUIRED":"#/components/schemas/DisclosurePublicErrorOwnerStrongTwoFactorRequired","MONITORING_NOT_IN_PLAN":"#/components/schemas/DisclosurePublicErrorMonitoringNotInPlan","MONITOR_CADENCE_NOT_IN_PLAN":"#/components/schemas/DisclosurePublicErrorMonitorCadenceNotInPlan","WEBHOOKS_NOT_IN_PLAN":"#/components/schemas/DisclosurePublicErrorWebhooksNotInPlan"}}}},"required":["error"],"additionalProperties":false},"DisclosurePublicErrorScopeForbidden":{"type":"object","properties":{"code":{"type":"string","enum":["SCOPE_FORBIDDEN"]},"message":{"type":"string","enum":["This API key does not grant the required permission."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorFreeOrganizationLimitReached":{"type":"object","properties":{"code":{"type":"string","enum":["FREE_ORGANIZATION_LIMIT_REACHED"]},"message":{"type":"string","enum":["Your account already owns a Free organization."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorTwoFactorRequired":{"type":"object","properties":{"code":{"type":"string","enum":["TWO_FACTOR_REQUIRED"]},"message":{"type":"string","enum":["This organization requires two-factor authentication. Set it up to continue."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorOwnerTwoFactorRequired":{"type":"object","properties":{"code":{"type":"string","enum":["OWNER_TWO_FACTOR_REQUIRED"]},"message":{"type":"string","enum":["Turn on two-factor authentication for your own account first."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorStrongerTwoFactorRequired":{"type":"object","properties":{"code":{"type":"string","enum":["STRONGER_TWO_FACTOR_REQUIRED"]},"message":{"type":"string","enum":["This organization requires a passkey or authenticator app. Add one to continue."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorOwnerStrongTwoFactorRequired":{"type":"object","properties":{"code":{"type":"string","enum":["OWNER_STRONG_TWO_FACTOR_REQUIRED"]},"message":{"type":"string","enum":["Add a passkey or authenticator app to your own account first."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorMonitoringNotInPlan":{"type":"object","properties":{"code":{"type":"string","enum":["MONITORING_NOT_IN_PLAN"]},"message":{"type":"string","enum":["Your plan does not include monitors in this environment."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorMonitorCadenceNotInPlan":{"type":"object","properties":{"code":{"type":"string","enum":["MONITOR_CADENCE_NOT_IN_PLAN"]},"message":{"type":"string","enum":["Your plan does not include this monitor cadence."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorWebhooksNotInPlan":{"type":"object","properties":{"code":{"type":"string","enum":["WEBHOOKS_NOT_IN_PLAN"]},"message":{"type":"string","enum":["Your plan does not include webhook endpoints in this environment."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorBody409":{"type":"object","properties":{"error":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable"},{"$ref":"#/components/schemas/DisclosurePublicErrorIdempotencyConflict"},{"$ref":"#/components/schemas/DisclosurePublicErrorBulkActiveJobLimitExceeded"},{"$ref":"#/components/schemas/DisclosurePublicErrorOperationInProgress"},{"$ref":"#/components/schemas/DisclosurePublicErrorOperationInterrupted"},{"$ref":"#/components/schemas/DisclosurePublicErrorAnnotationLimit"},{"$ref":"#/components/schemas/DisclosurePublicErrorAnnotationConflict"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitorLimitReached"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitorAlreadyExists"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitorDeleted"},{"$ref":"#/components/schemas/DisclosurePublicErrorWebhookEndpointLimitReached"},{"$ref":"#/components/schemas/DisclosurePublicErrorWebhookEndpointDisabled"},{"$ref":"#/components/schemas/DisclosurePublicErrorWebhookEndpointExists"},{"$ref":"#/components/schemas/DisclosurePublicErrorWebhookDeliveryInProgress"}],"discriminator":{"propertyName":"code","mapping":{"PUBLIC_DELIVERY_UNAVAILABLE":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable","IDEMPOTENCY_CONFLICT":"#/components/schemas/DisclosurePublicErrorIdempotencyConflict","BULK_ACTIVE_JOB_LIMIT_EXCEEDED":"#/components/schemas/DisclosurePublicErrorBulkActiveJobLimitExceeded","OPERATION_IN_PROGRESS":"#/components/schemas/DisclosurePublicErrorOperationInProgress","OPERATION_INTERRUPTED":"#/components/schemas/DisclosurePublicErrorOperationInterrupted","ANNOTATION_LIMIT":"#/components/schemas/DisclosurePublicErrorAnnotationLimit","ANNOTATION_CONFLICT":"#/components/schemas/DisclosurePublicErrorAnnotationConflict","MONITOR_LIMIT_REACHED":"#/components/schemas/DisclosurePublicErrorMonitorLimitReached","MONITOR_ALREADY_EXISTS":"#/components/schemas/DisclosurePublicErrorMonitorAlreadyExists","MONITOR_DELETED":"#/components/schemas/DisclosurePublicErrorMonitorDeleted","WEBHOOK_ENDPOINT_LIMIT_REACHED":"#/components/schemas/DisclosurePublicErrorWebhookEndpointLimitReached","WEBHOOK_ENDPOINT_DISABLED":"#/components/schemas/DisclosurePublicErrorWebhookEndpointDisabled","WEBHOOK_ENDPOINT_EXISTS":"#/components/schemas/DisclosurePublicErrorWebhookEndpointExists","WEBHOOK_DELIVERY_IN_PROGRESS":"#/components/schemas/DisclosurePublicErrorWebhookDeliveryInProgress"}}}},"required":["error"],"additionalProperties":false},"DisclosurePublicErrorIdempotencyConflict":{"type":"object","properties":{"code":{"type":"string","enum":["IDEMPOTENCY_CONFLICT"]},"message":{"type":"string","enum":["This idempotency key was already used with a different request.","This bulk idempotency key was already used with a different request."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorBulkActiveJobLimitExceeded":{"type":"object","properties":{"code":{"type":"string","enum":["BULK_ACTIVE_JOB_LIMIT_EXCEEDED"]},"message":{"type":"string","enum":["Your plan's limit on active bulk jobs is reached. Let an active job finish or cancel it, then try again."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorOperationInProgress":{"type":"object","properties":{"code":{"type":"string","enum":["OPERATION_IN_PROGRESS"]},"message":{"type":"string","enum":["This operation is still in progress. Retry using the same idempotency key.","Standing is still pending."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorOperationInterrupted":{"type":"object","properties":{"code":{"type":"string","enum":["OPERATION_INTERRUPTED"]},"message":{"type":"string","enum":["This operation was interrupted. Its outcome is unknown; a new request needs a new idempotency key."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorAnnotationLimit":{"type":"object","properties":{"code":{"type":"string","enum":["ANNOTATION_LIMIT"]},"message":{"type":"string","enum":["This record has reached its limit of reference changes."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorAnnotationConflict":{"type":"object","properties":{"code":{"type":"string","enum":["ANNOTATION_CONFLICT"]},"message":{"type":"string","enum":["The references changed at the same time. Reload the record and try again."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorMonitorLimitReached":{"type":"object","properties":{"code":{"type":"string","enum":["MONITOR_LIMIT_REACHED"]},"message":{"type":"string","enum":["Your plan's monitor slots are all in use."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorMonitorAlreadyExists":{"type":"object","properties":{"code":{"type":"string","enum":["MONITOR_ALREADY_EXISTS"]},"message":{"type":"string","enum":["A monitor for this subject already exists in this environment."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorMonitorDeleted":{"type":"object","properties":{"code":{"type":"string","enum":["MONITOR_DELETED"]},"message":{"type":"string","enum":["This monitor was deleted and cannot be changed."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorWebhookEndpointLimitReached":{"type":"object","properties":{"code":{"type":"string","enum":["WEBHOOK_ENDPOINT_LIMIT_REACHED"]},"message":{"type":"string","enum":["Your plan's webhook endpoints are all in use."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorWebhookEndpointDisabled":{"type":"object","properties":{"code":{"type":"string","enum":["WEBHOOK_ENDPOINT_DISABLED"]},"message":{"type":"string","enum":["This endpoint is disabled. Enable it before sending events."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorWebhookEndpointExists":{"type":"object","properties":{"code":{"type":"string","enum":["WEBHOOK_ENDPOINT_EXISTS"]},"message":{"type":"string","enum":["A webhook endpoint with this URL already exists with different settings."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorWebhookDeliveryInProgress":{"type":"object","properties":{"code":{"type":"string","enum":["WEBHOOK_DELIVERY_IN_PROGRESS"]},"message":{"type":"string","enum":["This delivery is already scheduled."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicHttpError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["PUBLIC_DELIVERY_UNAVAILABLE"]},"message":{"type":"string","enum":["Public delivery unavailable."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false},"DisclosurePublicErrorBody429":{"type":"object","properties":{"error":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable"},{"$ref":"#/components/schemas/DisclosurePublicErrorEmailCodeRateLimited"},{"$ref":"#/components/schemas/DisclosurePublicErrorQuotaExceeded"},{"$ref":"#/components/schemas/DisclosurePublicErrorRateLimited"},{"$ref":"#/components/schemas/DisclosurePublicErrorWebhookTestRateLimited"}],"discriminator":{"propertyName":"code","mapping":{"PUBLIC_DELIVERY_UNAVAILABLE":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable","EMAIL_CODE_RATE_LIMITED":"#/components/schemas/DisclosurePublicErrorEmailCodeRateLimited","QUOTA_EXCEEDED":"#/components/schemas/DisclosurePublicErrorQuotaExceeded","RATE_LIMITED":"#/components/schemas/DisclosurePublicErrorRateLimited","WEBHOOK_TEST_RATE_LIMITED":"#/components/schemas/DisclosurePublicErrorWebhookTestRateLimited"}}}},"required":["error"],"additionalProperties":false},"DisclosurePublicErrorEmailCodeRateLimited":{"type":"object","properties":{"code":{"type":"string","enum":["EMAIL_CODE_RATE_LIMITED"]},"message":{"type":"string","enum":["Wait a moment before asking for another code."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorQuotaExceeded":{"type":"object","properties":{"code":{"type":"string","enum":["QUOTA_EXCEEDED"]},"message":{"type":"string","enum":["This month's included allowance has been used or reserved.","This month's included allowance for this operation has been used or reserved."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorRateLimited":{"type":"object","properties":{"code":{"type":"string","enum":["RATE_LIMITED"]},"message":{"type":"string","enum":["Too many requests. Try again later."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorWebhookTestRateLimited":{"type":"object","properties":{"code":{"type":"string","enum":["WEBHOOK_TEST_RATE_LIMITED"]},"message":{"type":"string","enum":["Too many test events for this endpoint. Try again later."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorBody503":{"type":"object","properties":{"error":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable"},{"$ref":"#/components/schemas/DisclosurePublicErrorReferencesUncertain"}],"discriminator":{"propertyName":"code","mapping":{"PUBLIC_DELIVERY_UNAVAILABLE":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable","REFERENCES_UNCERTAIN":"#/components/schemas/DisclosurePublicErrorReferencesUncertain"}}}},"required":["error"],"additionalProperties":false},"DisclosurePublicErrorReferencesUncertain":{"type":"object","properties":{"code":{"type":"string","enum":["REFERENCES_UNCERTAIN"]},"message":{"type":"string","enum":["The references could not be confirmed. Retry with the same idempotency key."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"PublicVatValidationInput":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Za-z]{2}$"},"vatNumber":{"type":"string","minLength":3,"maxLength":32,"pattern":"^[A-Za-z0-9 .+*-]+$"},"mode":{"type":"string","enum":["sandbox","live"],"default":"sandbox"},"maxAgeSeconds":{"type":"integer","minimum":0,"maximum":2147483647},"allowStale":{"type":"boolean"}},"required":["countryCode","vatNumber"],"additionalProperties":false},"PublicCompanySearchInput":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Za-z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"mode":{"type":"string","enum":["sandbox","live"],"default":"sandbox"},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5},"maxAgeSeconds":{"type":"integer","minimum":0,"maximum":2147483647},"allowStale":{"type":"boolean"}},"required":["countryCode","query"],"additionalProperties":false},"PublicCompanyResolutionInputV2":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Za-z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"mode":{"type":"string","enum":["live"]},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5},"maxAgeSeconds":{"type":"integer","minimum":0,"maximum":2147483647},"allowStale":{"type":"boolean"}},"required":["countryCode","query","mode"],"additionalProperties":false},"DisclosurePublicErrorBody429Discovery":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicErrorBody429"},{"$ref":"#/components/schemas/DisclosurePublicQuotaExceededError"}]},"DisclosurePublicQuotaExceededError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["QUOTA_EXCEEDED"]},"message":{"type":"string","enum":["This month's included allowance for this operation has been used or reserved."]},"meter":{"type":"string","enum":["vat_discovery"]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message","meter"],"additionalProperties":false}},"required":["error"],"additionalProperties":false},"PublicCompanyWebSearchInputV2":{"type":"object","properties":{"query":{"type":"string","minLength":2,"maxLength":160,"description":"Company legal name, LEI, EUID or labeled DUNS query. Typed identifiers do not require a country filter."},"identifier":{"$ref":"#/components/schemas/CompanySearchIdentifier"},"dunsSourceUrl":{"type":"string","minLength":1,"maxLength":2048},"includeVat":{"type":"boolean"},"validateVat":{"type":"boolean"},"jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1,"maxItems":3},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"mode":{"type":"string","enum":["live"],"default":"live"},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5},"maxAgeSeconds":{"type":"integer","minimum":0},"allowStale":{"type":"boolean"}},"required":["query"],"additionalProperties":false},"CompanySearchIdentifier":{"type":"object","properties":{"type":{"type":"string","enum":["lei","euid","duns"]},"value":{"type":"string","minLength":1,"maxLength":160}},"required":["type","value"],"additionalProperties":false},"DisclosurePublicWebSearchCapabilitiesDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"environment":{"type":"string","enum":["live"]},"coverage":{"type":"string","enum":["source_scoped"]},"jurisdictions":{"type":"array","items":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"available":{"type":"boolean"},"customerDelivery":{"type":"string","enum":["requires_current_admission"]},"sourceCategories":{"type":"array","items":{"type":"string","enum":["unclassified_public_source","company_publication","synthetic"]},"maxItems":3}},"required":["jurisdiction","available","customerDelivery","sourceCategories"],"additionalProperties":false},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","environment","coverage","jurisdictions"],"additionalProperties":false},"PublicCompanyWebVerificationInputV2":{"type":"object","properties":{"searchOperationId":{"type":"string","format":"uuid"},"candidateIndex":{"type":"integer","minimum":0,"maximum":9},"mode":{"type":"string","enum":["live"],"default":"live"},"claims":{"$ref":"#/components/schemas/PublicCompanyWebVerificationClaimsV2"}},"required":["searchOperationId","candidateIndex"],"additionalProperties":false},"PublicCompanyWebVerificationClaimsV2":{"type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":500},"companyId":{"type":"string","minLength":1,"maxLength":160},"taxId":{"type":"string","minLength":1,"maxLength":160},"vatId":{"type":"string","minLength":1,"maxLength":160},"publishedAddress":{"type":"string","minLength":1,"maxLength":500}},"default":{},"additionalProperties":false},"DisclosurePublicProductCapabilitiesDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"environment":{"type":"string","enum":["live"]},"evaluatedAt":{"type":"string","format":"date-time"},"coverage":{"type":"string","enum":["source_scoped"]},"entries":{"type":"array","items":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"capability":{"type":"string","enum":["company_search","company_verification","vat_discovery"]},"availability":{"type":"string","enum":["live","partially_supported"]},"customerDelivery":{"type":"string","enum":["requires_current_admission"]},"methods":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["certified_registry","public_sources"]},"endpoint":{"type":"string","enum":["/v1/companies/search","/v1/company-searches","/v1/company-verifications","/v1/company-vat-discoveries","/v1/company-web-searches","/v1/company-web-verifications"]},"sourceCategories":{"type":"array","items":{"type":"string","enum":["unclassified_public_source","company_publication","synthetic"]},"maxItems":3}},"required":["kind","endpoint","sourceCategories"],"additionalProperties":false},"maxItems":2}},"required":["jurisdiction","capability","availability","customerDelivery","methods"],"additionalProperties":false},"maxItems":150}},"required":["schemaVersion","disclosurePolicyVersion","environment","evaluatedAt","coverage","entries"],"additionalProperties":false},"PublicCompanyVerificationInput":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Za-z]{2}$"},"register":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"registryId":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9 .-]+$"},"mode":{"type":"string","enum":["sandbox","live"],"default":"sandbox"},"claims":{"type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":240},"registeredAddress":{"type":"string","minLength":1,"maxLength":500},"countryCode":{"type":"string","pattern":"^[A-Za-z]{2}$"},"status":{"type":"string","enum":["active","ceased"]}},"default":{},"additionalProperties":false},"maxAgeSeconds":{"type":"integer","minimum":0,"maximum":2147483647},"allowStale":{"type":"boolean"}},"required":["countryCode","register","registryId"],"additionalProperties":false},"PublicCompanyVatDiscoveryInput":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Za-z]{2}$"},"register":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"registryId":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9 .-]+$"},"mode":{"type":"string","enum":["sandbox","live"],"default":"sandbox"},"validateVat":{"type":"boolean","default":true},"maxAgeSeconds":{"type":"integer","minimum":0,"maximum":2147483647},"allowStale":{"type":"boolean"}},"required":["countryCode","register","registryId"],"additionalProperties":false},"DisclosurePublicSelectionReceiptDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"family":{"type":"string","enum":["selection_receipt"]},"id":{"type":"string","format":"uuid"},"searchOperationId":{"type":"string","format":"uuid"},"environment":{"type":"string","enum":["sandbox","live"]},"candidateRank":{"type":"integer","minimum":1,"maximum":100},"replayed":{"type":"boolean"}},"required":["schemaVersion","disclosurePolicyVersion","family","id","searchOperationId","environment","candidateRank","replayed"],"additionalProperties":false},"DisclosurePublicErrorBody404":{"type":"object","properties":{"error":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitorNotFound"},{"$ref":"#/components/schemas/DisclosurePublicErrorMonitorChangeNotFound"},{"$ref":"#/components/schemas/DisclosurePublicErrorWebhookEndpointNotFound"},{"$ref":"#/components/schemas/DisclosurePublicErrorWebhookDeliveryNotFound"}],"discriminator":{"propertyName":"code","mapping":{"PUBLIC_DELIVERY_UNAVAILABLE":"#/components/schemas/DisclosurePublicErrorPublicDeliveryUnavailable","MONITOR_NOT_FOUND":"#/components/schemas/DisclosurePublicErrorMonitorNotFound","MONITOR_CHANGE_NOT_FOUND":"#/components/schemas/DisclosurePublicErrorMonitorChangeNotFound","WEBHOOK_ENDPOINT_NOT_FOUND":"#/components/schemas/DisclosurePublicErrorWebhookEndpointNotFound","WEBHOOK_DELIVERY_NOT_FOUND":"#/components/schemas/DisclosurePublicErrorWebhookDeliveryNotFound"}}}},"required":["error"],"additionalProperties":false},"DisclosurePublicErrorMonitorNotFound":{"type":"object","properties":{"code":{"type":"string","enum":["MONITOR_NOT_FOUND"]},"message":{"type":"string","enum":["No monitor with this ID exists in this environment."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorMonitorChangeNotFound":{"type":"object","properties":{"code":{"type":"string","enum":["MONITOR_CHANGE_NOT_FOUND"]},"message":{"type":"string","enum":["No observed change with this ID exists in this environment."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorWebhookEndpointNotFound":{"type":"object","properties":{"code":{"type":"string","enum":["WEBHOOK_ENDPOINT_NOT_FOUND"]},"message":{"type":"string","enum":["No webhook endpoint with this ID exists in this environment."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"DisclosurePublicErrorWebhookDeliveryNotFound":{"type":"object","properties":{"code":{"type":"string","enum":["WEBHOOK_DELIVERY_NOT_FOUND"]},"message":{"type":"string","enum":["No webhook delivery with this ID exists for this endpoint."]},"request_id":{"$ref":"#/components/schemas/DisclosureRequestId"}},"required":["code","message"],"additionalProperties":false},"CompanySearchCandidateSelectionInputV1":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/VerificationEnvironment"},"candidate":{"$ref":"#/components/schemas/LegalEntityIdentity"}},"required":["mode","candidate"],"additionalProperties":false},"VerificationEnvironment":{"type":"string","enum":["sandbox","live"]},"LegalEntityIdentity":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"register":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"registryId":{"type":"string","minLength":1,"maxLength":160}},"required":["jurisdiction","register","registryId"],"additionalProperties":false},"DisclosurePublicDeliveryHistory":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicOperationPayload"}},"nextCursor":{"$ref":"#/components/schemas/PublicVerificationHistoryCursorV1"}},"required":["schemaVersion","items","nextCursor"],"additionalProperties":false},"PublicVerificationHistoryCursorV1":{"type":["string","null"],"minLength":1,"maxLength":512,"pattern":"^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$"},"PublicRecordAnnotations":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["record-annotations-v1"]},"operationId":{"type":"string","format":"uuid"},"current":{"$ref":"#/components/schemas/RecordReferences"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicRecordAnnotation"},"maxItems":200}},"required":["schemaVersion","operationId","current","items"],"additionalProperties":false},"RecordReferences":{"type":["object","null"],"properties":{"order_reference":{"type":["string","null"],"minLength":1,"maxLength":100,"pattern":"^[^\\p{Cc}\\p{Cf}]*$"},"invoice_reference":{"type":["string","null"],"minLength":1,"maxLength":100,"pattern":"^[^\\p{Cc}\\p{Cf}]*$"},"customs_declaration_reference":{"type":["string","null"],"pattern":"^[0-9]{2}[A-Za-z]{2}[A-Za-z0-9]{14}$"},"comment":{"type":["string","null"],"minLength":1,"maxLength":500,"pattern":"^[^\\p{Cc}\\p{Cf}]*$"}},"required":["order_reference","invoice_reference","customs_declaration_reference","comment"],"additionalProperties":false},"PublicRecordAnnotation":{"type":"object","properties":{"sequence":{"type":"integer","minimum":0},"kind":{"type":"string","enum":["submitted","edited"]},"references":{"$ref":"#/components/schemas/RecordReferences"},"actor":{"type":"object","properties":{"type":{"type":"string","enum":["user","api_key","oauth_grant"]},"id":{"type":"string","minLength":1,"maxLength":128},"label":{"type":"string","minLength":1,"maxLength":200}},"required":["type","id"],"additionalProperties":false},"recordedAt":{"type":"string","format":"date-time"}},"required":["sequence","kind","references","actor","recordedAt"],"additionalProperties":false},"PublicCounterpartyPage":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["counterparties-v1"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicCounterparty"},"maxItems":50},"nextCursor":{"type":["string","null"],"maxLength":256}},"required":["schemaVersion","items","nextCursor"],"additionalProperties":false},"PublicCounterparty":{"type":"object","properties":{"vatId":{"type":"string","pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"checks":{"type":"integer","minimum":1},"lastCheckedAt":{"type":"string","format":"date-time"},"latestOperationId":{"type":"string","format":"uuid"},"latest":{"$ref":"#/components/schemas/DisclosurePublicOperationPayload"}},"required":["vatId","countryCode","checks","lastCheckedAt","latestOperationId","latest"],"additionalProperties":false},"MonitorV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monitors-v1"]},"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","minLength":1,"maxLength":128},"environment":{"type":"string","enum":["live","sandbox"]},"subject":{"$ref":"#/components/schemas/MonitorSubjectV1"},"watchedFacts":{"type":"array","items":{"$ref":"#/components/schemas/MonitorWatchedFactV1"},"minItems":1,"maxItems":8},"cadence":{"$ref":"#/components/schemas/MonitorCadenceV1"},"state":{"$ref":"#/components/schemas/MonitorStateV1"},"counterpartyVatId":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"pausedAt":{"type":["string","null"],"format":"date-time"},"deletedAt":{"type":["string","null"],"format":"date-time"},"lastRunAt":{"type":["string","null"],"format":"date-time"},"nextRunAt":{"type":["string","null"],"format":"date-time"},"lastDefinitiveObservedAt":{"type":["string","null"],"format":"date-time"},"cannotSeeSince":{"type":["string","null"],"format":"date-time"},"factStatus":{"type":"array","items":{"type":"object","properties":{"fact":{"$ref":"#/components/schemas/MonitorWatchedFactV1"},"lastDefinitiveObservedAt":{"type":["string","null"],"format":"date-time"},"lastOutcome":{"type":["string","null"],"enum":["definitive","not_observed",null]},"lastNotObservedReason":{"$ref":"#/components/schemas/MonitorNotObservedReasonV1"}},"required":["fact","lastDefinitiveObservedAt","lastOutcome","lastNotObservedReason"],"additionalProperties":false},"minItems":1,"maxItems":8}},"required":["schemaVersion","id","organizationId","environment","subject","watchedFacts","cadence","state","counterpartyVatId","createdAt","updatedAt","pausedAt","deletedAt","lastRunAt","nextRunAt","lastDefinitiveObservedAt","cannotSeeSince","factStatus"],"additionalProperties":false},"MonitorCadenceV1":{"type":"string","enum":["daily","weekly","monthly"]},"MonitorStateV1":{"type":"string","enum":["active","paused","cannot_see","deleted"]},"MonitorCreateRequestV1":{"type":"object","properties":{"subject":{"$ref":"#/components/schemas/MonitorSubjectInputV1"},"watchedFacts":{"type":"array","items":{"$ref":"#/components/schemas/MonitorWatchedFactV1"},"minItems":1,"maxItems":8},"cadence":{"$ref":"#/components/schemas/MonitorCadenceV1"},"counterpartyVatId":{"type":"string","pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"mode":{"type":"string","enum":["sandbox","live"]}},"required":["subject"],"additionalProperties":false},"MonitorSubjectInputV1":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["vat_id"]},"countryCode":{"type":"string","pattern":"^[A-Za-z]{2}$"},"vatNumber":{"type":"string","minLength":2,"maxLength":40,"pattern":"^[A-Za-z0-9 .+*-]+$"}},"required":["kind","countryCode","vatNumber"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["company"]},"jurisdiction":{"type":"string","pattern":"^[A-Za-z]{2}$"},"registryId":{"type":"string","minLength":1,"maxLength":160}},"required":["kind","jurisdiction","registryId"],"additionalProperties":false}]},"MonitorListResponseV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monitors-v1"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/MonitorV1"},"maxItems":100},"nextCursor":{"type":["string","null"],"maxLength":512}},"required":["schemaVersion","items","nextCursor"],"additionalProperties":false},"MonitorUpdateRequestV1":{"type":"object","properties":{"cadence":{"$ref":"#/components/schemas/MonitorCadenceV1"},"watchedFacts":{"type":"array","items":{"$ref":"#/components/schemas/MonitorWatchedFactV1"},"minItems":1,"maxItems":8}},"additionalProperties":false},"MonitorObservedChangeListResponseV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monitor-changes-v1"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/MonitorObservedChangeV1"},"maxItems":100},"nextCursor":{"type":["string","null"],"maxLength":512}},"required":["schemaVersion","items","nextCursor"],"additionalProperties":false},"RequesterDefaultView":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["requester-default-v1"]},"requester_vat_id":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"billing_entity_name":{"type":["string","null"]},"verification":{"$ref":"#/components/schemas/RequesterVerificationView"}},"required":["schemaVersion","requester_vat_id","updatedAt"],"additionalProperties":false},"RequesterVerificationView":{"type":["object","null"],"properties":{"state":{"type":"string","enum":["verified","attestation_required","pending","unverified","revalidation_failed"]},"method":{"type":"string","enum":["authority_name","member_attestation"]},"reason":{"type":"string","enum":["name_disagrees","billing_entity_name_missing","vat_invalid","requester_rejected","vies_unavailable"]},"last_revalidated_at":{"type":["string","null"],"format":"date-time"}},"required":["state","last_revalidated_at"],"additionalProperties":false},"RequesterDefaultReplace":{"type":"object","properties":{"requester_vat_id":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9+*]{2,30}$"},"billing_entity_name":{"type":["string","null"],"minLength":1,"maxLength":200},"member_attestation":{"type":"boolean","enum":[true]}},"required":["requester_vat_id"],"additionalProperties":false},"DisclosurePublicFullCompanyResourceDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"data":{"$ref":"#/components/schemas/DisclosurePublicCompanyData"},"provenance":{"$ref":"#/components/schemas/DisclosurePublicResourceProvenance"},"usage":{"$ref":"#/components/schemas/DisclosurePublicResourceUsage"},"resolution":{"$ref":"#/components/schemas/DisclosurePublicResourceResolution"},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","data","usage","fieldTrust"],"additionalProperties":false},"DisclosurePublicCompanyData":{"type":"object","properties":{"id":{"type":"string","maxLength":8192},"legal_name":{"type":"string","maxLength":8192},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"brand_name":{"type":["string","null"],"maxLength":8192},"trade_names":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":20},"website":{"type":"string","format":"uri"},"company_id":{"type":["string","null"],"maxLength":8192},"tax_id":{"type":["string","null"],"maxLength":8192},"lei":{"type":["string","null"],"maxLength":8192},"lifecycle":{"$ref":"#/components/schemas/CompanyLifecycleSummaryV1"},"activities":{"type":"array","items":{"$ref":"#/components/schemas/CompanyActivitySummaryV1"},"maxItems":20},"business_description":{"oneOf":[{"$ref":"#/components/schemas/CompanyBusinessDescriptionSummaryV1"},{"type":"null"}]},"contacts":{"$ref":"#/components/schemas/CompanyContactsSummaryV1"},"vat":{"type":["object","null"],"properties":{"id":{"type":"string","maxLength":8192},"status":{"type":"string","enum":["valid","invalid","unavailable","unknown","unsupported"],"description":"Validity confirms registration only and does not show that the number belongs to your customer."},"checked_at":{"type":["string","null"],"format":"date-time"},"evidence_refs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["id","status","checked_at"],"additionalProperties":false},"derived_vat_candidate":{"$ref":"#/components/schemas/DisclosurePublicDerivedVatCandidateOutcome"},"address":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicAddress"},{"type":"string","maxLength":8192},{"type":"null"}]},"legal_entity":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicLegalEntity"},{"type":"null"}]},"facts":{"$ref":"#/components/schemas/DisclosurePublicCompanyFacts"},"leiRegistration":{"$ref":"#/components/schemas/DisclosurePublicLeiRegistration"},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompanyIdentifier"},"maxItems":200},"identity_state":{"type":"string","enum":["authority_confirmed","source_attributed","partial_correlation","company_claimed","synthetic","discovered","conflicting","derived_candidate"]},"field_provenance":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicFieldProvenance"},"maxItems":100},"completeness":{"type":"string","enum":["partial","complete"]},"missing_fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicMissingField"},"maxItems":100}},"required":["id","legal_name","jurisdiction"],"additionalProperties":false},"CompanyLifecycleSummaryV1":{"type":"object","properties":{"incorporation_date":{"type":["string","null"],"format":"date"},"cessation_date":{"type":["string","null"],"format":"date"}},"required":["incorporation_date","cessation_date"],"additionalProperties":false},"CompanyActivitySummaryV1":{"type":"object","properties":{"scheme":{"type":"string","minLength":1,"maxLength":160},"code":{"type":"string","minLength":1,"maxLength":160},"nace_code":{"type":["string","null"],"pattern":"^\\d{2}(?:\\.\\d{1,2})?$"},"label":{"type":["string","null"],"minLength":1,"maxLength":2000},"label_native":{"type":["string","null"],"minLength":1,"maxLength":2000},"label_en":{"type":["string","null"],"minLength":1,"maxLength":2000},"primary":{"type":"boolean"}},"required":["scheme","code"],"additionalProperties":false},"CompanyBusinessDescriptionSummaryV1":{"type":"object","properties":{"summary_en":{"type":["string","null"],"minLength":1,"maxLength":2000},"native_text":{"type":["string","null"],"minLength":1,"maxLength":4000},"native_language":{"type":["string","null"],"pattern":"^[a-z]{2}$"},"source_kind":{"type":"string","enum":["statutory_object","statutory_corporate_object","activity_classification","activity_classification_summary","published_company_profile","company_self_description","combined_statutory_and_activity"]}},"required":["summary_en","native_text","native_language","source_kind"],"additionalProperties":false},"CompanyContactsSummaryV1":{"type":"object","properties":{"websites":{"type":"array","items":{"type":"string","minLength":1,"maxLength":2000},"maxItems":20},"emails":{"type":"array","items":{"type":"string","minLength":1,"maxLength":320},"maxItems":20},"digital_domiciles":{"type":"array","items":{"type":"string","minLength":1,"maxLength":320},"maxItems":20},"phones":{"type":"array","items":{"$ref":"#/components/schemas/CompanyPhoneContactV1"},"maxItems":20}},"additionalProperties":false},"CompanyPhoneContactV1":{"type":"object","properties":{"raw":{"type":"string","minLength":1,"maxLength":200},"e164":{"type":["string","null"],"pattern":"^\\+[1-9]\\d{4,14}$"},"country_calling_code":{"type":["string","null"],"pattern":"^\\+[1-9]\\d{0,3}$"},"national_number":{"type":["string","null"],"minLength":1,"maxLength":32},"phone_type":{"$ref":"#/components/schemas/PhoneTypeV1"},"country_code":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"state":{"type":"string"},"evidence_refs":{"type":"array","items":{"type":"string"}}},"required":["raw","e164","country_calling_code","national_number","phone_type","country_code"],"additionalProperties":false},"PhoneTypeV1":{"type":"string","enum":["fixed_line","mobile","toll_free","shared_cost","premium_rate","voip","personal_number","pager","uan","unknown"]},"DisclosurePublicLeiRegistration":{"type":"object","properties":{"legalJurisdiction":{"type":"string","pattern":"^[A-Z]{2}(?:-[A-Z0-9]{1,3})?$"},"entityStatus":{"type":"string","maxLength":8192},"registrationStatus":{"type":"string","maxLength":8192},"initialRegistrationDate":{"type":["string","null"],"maxLength":8192},"lastUpdateDate":{"type":["string","null"],"maxLength":8192},"nextRenewalDate":{"type":["string","null"],"maxLength":8192},"registrationAuthorityId":{"type":["string","null"],"maxLength":8192},"registeredAs":{"type":["string","null"],"maxLength":8192},"goldenCopyPublishedAt":{"type":["string","null"],"maxLength":8192}},"required":["entityStatus","registrationStatus","initialRegistrationDate","lastUpdateDate","nextRenewalDate","registrationAuthorityId","registeredAs","goldenCopyPublishedAt"],"additionalProperties":false},"DisclosurePublicResourceProvenance":{"type":"object","properties":{"sources":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"maxItems":1000},"evidence_count":{"type":"integer","minimum":0},"retrieved_at":{"type":"string","format":"date-time"}},"required":["sources"],"additionalProperties":false},"DisclosurePublicResourceUsage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0},"operation_id":{"type":"string","minLength":1,"maxLength":160},"meter":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]}},"required":["units_charged"],"additionalProperties":false},"DisclosurePublicResourceResolution":{"type":"object","properties":{"outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unsupported","freemail_unresolved"]},"identity_confirmed":{"type":"boolean"},"total_results":{"type":["integer","null"],"minimum":0},"truncated":{"type":"boolean"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"},"maxItems":1000},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"maxItems":30}},"required":["outcome","identity_confirmed","total_results","truncated","sources"],"additionalProperties":false},"DisclosurePublicCompactCompanyResourceDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"data":{"$ref":"#/components/schemas/DisclosurePublicCompactCompanyData"},"provenance":{"$ref":"#/components/schemas/DisclosurePublicResourceProvenance"},"usage":{"$ref":"#/components/schemas/DisclosurePublicResourceUsage"},"resolution":{"$ref":"#/components/schemas/DisclosurePublicResourceResolution"},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","data","usage","fieldTrust"],"additionalProperties":false},"DisclosurePublicCompactCompanyData":{"type":"object","properties":{"id":{"type":"string","maxLength":8192},"legal_name":{"type":"string","maxLength":8192},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"brand_name":{"type":["string","null"],"maxLength":8192},"trade_names":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":20},"website":{"type":"string","format":"uri"},"company_id":{"type":["string","null"],"maxLength":8192},"lifecycle":{"$ref":"#/components/schemas/CompanyLifecycleSummaryV1"},"activities":{"type":"array","items":{"$ref":"#/components/schemas/CompanyActivitySummaryV1"},"maxItems":20},"business_description":{"oneOf":[{"$ref":"#/components/schemas/CompanyBusinessDescriptionSummaryV1"},{"type":"null"}]},"contacts":{"$ref":"#/components/schemas/CompanyContactsSummaryV1"},"derived_vat_candidate":{"$ref":"#/components/schemas/DisclosurePublicDerivedVatCandidateOutcome"},"legal_entity":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicLegalEntity"},{"type":"null"}]},"facts":{"$ref":"#/components/schemas/DisclosurePublicCompanyFacts"},"leiRegistration":{"$ref":"#/components/schemas/DisclosurePublicLeiRegistration"},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompanyIdentifier"},"maxItems":200},"identity_state":{"type":"string","enum":["authority_confirmed","source_attributed","partial_correlation","company_claimed","synthetic","discovered","conflicting","derived_candidate"]},"field_provenance":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicFieldProvenance"},"maxItems":100},"completeness":{"type":"string","enum":["partial","complete"]},"missing_fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicMissingField"},"maxItems":100},"vat_id":{"type":["string","null"],"maxLength":8192},"vat_status":{"type":["string","null"],"enum":["valid","invalid","unavailable","unknown","unconfirmed",null]}},"required":["id","legal_name","jurisdiction","vat_id","vat_status"],"additionalProperties":false},"DisclosurePublicCompanyCollectionDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompanyCollectionItem"},"maxItems":100},"total_results":{"type":["integer","null"],"minimum":0},"resolution":{"$ref":"#/components/schemas/DisclosurePublicResourceResolution"},"usage":{"$ref":"#/components/schemas/DisclosurePublicResourceUsage"},"quota":{"$ref":"#/components/schemas/ResponseQuotaPayload"},"classification":{"type":"object","properties":{"input_kind":{"type":"string","enum":["email","url","domain","tax_or_vat_id","registry_id","lei","euid","duns","address","company_name"]},"detected_country":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"is_freemail":{"type":"boolean"}},"required":["input_kind"],"additionalProperties":false},"identifier_resolution":{"type":"object","properties":{"identifier":{"type":"object","properties":{"type":{"type":"string","enum":["lei","euid","duns"]},"value":{"type":"string","maxLength":8192}},"required":["type","value"],"additionalProperties":false},"vatEnrichment":{"type":"string","enum":["not_requested","found","not_disclosed","unsupported","source_unavailable","conflicting"]}},"required":["identifier","vatEnrichment"],"additionalProperties":false},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","items","total_results","resolution","fieldTrust"],"additionalProperties":false},"DisclosurePublicCompanyCollectionItem":{"type":"object","properties":{"id":{"type":"string","maxLength":8192},"brand_name":{"type":["string","null"],"maxLength":8192},"trade_names":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":20},"website":{"type":"string","format":"uri"},"company_id":{"type":["string","null"],"maxLength":8192},"tax_id":{"type":["string","null"],"maxLength":8192},"lei":{"type":["string","null"],"maxLength":8192},"lifecycle":{"$ref":"#/components/schemas/CompanyLifecycleSummaryV1"},"activities":{"type":"array","items":{"$ref":"#/components/schemas/CompanyActivitySummaryV1"},"maxItems":20},"business_description":{"oneOf":[{"$ref":"#/components/schemas/CompanyBusinessDescriptionSummaryV1"},{"type":"null"}]},"contacts":{"$ref":"#/components/schemas/CompanyContactsSummaryV1"},"derived_vat_candidate":{"$ref":"#/components/schemas/DisclosurePublicDerivedVatCandidateOutcome"},"address":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicAddress"},{"type":"string","maxLength":8192},{"type":"null"}]},"legal_entity":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicLegalEntity"},{"type":"null"}]},"facts":{"$ref":"#/components/schemas/DisclosurePublicCompanyFacts"},"leiRegistration":{"$ref":"#/components/schemas/DisclosurePublicLeiRegistration"},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCompanyIdentifier"},"maxItems":200},"identity_state":{"type":"string","enum":["authority_confirmed","source_attributed","partial_correlation","company_claimed","synthetic","discovered","conflicting","derived_candidate"]},"field_provenance":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicFieldProvenance"},"maxItems":100},"completeness":{"type":"string","enum":["partial","complete"]},"missing_fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicMissingField"},"maxItems":100},"legal_name":{"type":["string","null"],"maxLength":8192},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"status":{"type":["object","null"],"properties":{"standing":{"type":"string","enum":["active","dissolved","in_liquidation","bankrupt","inactive","unsupported"]},"verified_against_registry":{"type":"boolean"},"registry_identifier":{"type":["string","null"],"maxLength":8192}},"required":["standing","verified_against_registry"],"additionalProperties":false},"vat":{"type":["object","null"],"properties":{"vat_id":{"type":"string","maxLength":8192},"status":{"type":"string","enum":["valid","invalid","unavailable","unknown","unconfirmed"]},"checked_at":{"type":["string","null"],"format":"date-time"},"evidence_refs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["vat_id","status","checked_at","evidence_refs"],"additionalProperties":false},"vat_candidates":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","maxLength":8192},"basis":{"type":"string","enum":["explicit_public_claim","official_association"]},"viesStatus":{"type":"string","enum":["valid","invalid","unavailable","not_requested","not_applicable"]},"evidence_refs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["value","basis","viesStatus","evidence_refs"],"additionalProperties":false},"maxItems":5}},"required":["id","legal_name","country_code","evidenceRefs"],"additionalProperties":false},"ResponseQuotaPayload":{"type":"object","properties":{"vat_eu_queries":{"type":"object","properties":{"cost":{"type":"integer","minimum":0,"description":"Quota units consumed by this specific request"},"allowed":{"type":["integer","null"],"minimum":0,"description":"Total allowance in the current cycle, or null if unmetered"},"used":{"type":"integer","minimum":0,"description":"Total units consumed in the current cycle"},"remaining":{"type":["integer","null"],"minimum":0,"description":"Remaining units in current cycle"}},"required":["cost","allowed","used","remaining"],"description":"Authoritative VAT number checks against VIES"},"reverse_vat_lookups":{"type":"object","properties":{"cost":{"type":"integer","minimum":0,"description":"Quota units consumed by this specific request"},"allowed":{"type":["integer","null"],"minimum":0,"description":"Total allowance in the current cycle, or null if unmetered"},"used":{"type":"integer","minimum":0,"description":"Total units consumed in the current cycle"},"remaining":{"type":["integer","null"],"minimum":0,"description":"Remaining units in current cycle"}},"required":["cost","allowed","used","remaining"],"description":"Discovery of VAT numbers from company names, domains, or commercial registrations"},"company_searches":{"type":"object","properties":{"cost":{"type":"integer","minimum":0,"description":"Quota units consumed by this specific request"},"allowed":{"type":["integer","null"],"minimum":0,"description":"Total allowance in the current cycle, or null if unmetered"},"used":{"type":"integer","minimum":0,"description":"Total units consumed in the current cycle"},"remaining":{"type":["integer","null"],"minimum":0,"description":"Remaining units in current cycle"}},"required":["cost","allowed","used","remaining"],"description":"Fuzzy search, web search locator, and reconciliation of company profiles"},"company_status_verifications":{"type":"object","properties":{"cost":{"type":"integer","minimum":0,"description":"Quota units consumed by this specific request"},"allowed":{"type":["integer","null"],"minimum":0,"description":"Total allowance in the current cycle, or null if unmetered"},"used":{"type":"integer","minimum":0,"description":"Total units consumed in the current cycle"},"remaining":{"type":["integer","null"],"minimum":0,"description":"Remaining units in current cycle"}},"required":["cost","allowed","used","remaining"],"description":"Live corporate standing verification (active, dissolved, bankrupt, liquidation)"},"resets_at":{"type":"string","description":"ISO-8601 reset timestamp"}},"required":["vat_eu_queries","reverse_vat_lookups","company_searches","company_status_verifications","resets_at"]},"DisclosurePublicCompanyJsonLd":{"type":"object","properties":{"@context":{"type":"string","enum":["https://schema.org"]},"@type":{"type":"string","enum":["Organization"]},"name":{"type":"string","maxLength":8192},"identifier":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string","enum":["PropertyValue"]},"propertyID":{"type":"string","maxLength":8192},"value":{"type":"string","maxLength":8192}},"required":["@type","propertyID","value"],"additionalProperties":false},"maxItems":200},"url":{"type":"string","format":"uri"},"address":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicAddress"},{"type":"string","maxLength":8192}]}},"required":["@context","@type","name"],"additionalProperties":false},"DisclosurePublicVatResourceDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"data":{"type":"object","properties":{"vat_id":{"type":"string","maxLength":8192},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"outcome":{"type":"string","enum":["valid","invalid","unavailable","unknown","unsupported"]},"legal_name":{"type":["string","null"],"maxLength":8192},"address":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicAddress"},{"type":"null"}]},"legal_entity":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicLegalEntity"},{"type":"null"}]},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0}},"required":["vat_id","jurisdiction","outcome"],"additionalProperties":false},"provenance":{"$ref":"#/components/schemas/DisclosurePublicResourceProvenance"},"usage":{"$ref":"#/components/schemas/DisclosurePublicResourceUsage"},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","data","usage","fieldTrust"],"additionalProperties":false},"TaxAssessmentResultV1":{"type":"object","properties":{"schema_version":{"type":"string","enum":["2026-10-13"]},"rule_set_version":{"type":"string","enum":["canary-services-2026-10-13"]},"legal_reviewed_on":{"type":"string","enum":["2026-10-13"]},"assurance":{"type":"string","enum":["conditional_on_supplied_facts"]},"assessment_status":{"type":"string","enum":["assessed","needs_information","conflicting_evidence","unsupported_rule","source_unavailable"]},"missing_facts":{"type":"array","items":{"type":"string"}},"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"evidence_refs":{"type":"array","items":{"type":"string","minLength":1}}},"required":["code","message","evidence_refs"],"additionalProperties":false}},"tax_legs":{"type":"array","items":{"type":"object","properties":{"regime":{"type":"string","enum":["eu_vat","igic","national_vat"]},"jurisdiction":{"type":"string","minLength":1},"place_of_supply":{"type":"string","enum":["ES_CANARY","ES_MAINLAND_BALEARIC","AT_VAT","BE_VAT","BG_VAT","CY_VAT","CZ_VAT","DE_VAT","DK_VAT","EE_VAT","EL_VAT","GR_VAT","FI_VAT","FR_VAT","HR_VAT","HU_VAT","IE_VAT","IT_VAT","LT_VAT","LU_VAT","LV_VAT","MT_VAT","NL_VAT","PL_VAT","PT_VAT","RO_VAT","SE_VAT","SI_VAT","SK_VAT","XI_VAT","GB_VAT","CH_VAT","NO_VAT","IS_VAT","GE_VAT","RS_VAT","AL_VAT","UA_VAT","TR_VAT"]},"treatment":{"type":"string","enum":["outside_scope","taxable_supplier_charge","taxable_customer_accounted"]},"liable_party":{"type":["string","null"],"enum":["supplier","customer",null]},"supplier_action":{"type":"string","enum":["charge","do_not_charge"]},"rate":{"type":"null"},"tax_amount":{"type":"null"},"legal_basis_refs":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["regime","jurisdiction","place_of_supply","treatment","liable_party","supplier_action","rate","tax_amount","legal_basis_refs"],"additionalProperties":false}},"legal_basis":{"type":"array","items":{"type":"object","properties":{"article":{"type":"string","minLength":1},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"effective_from":{"type":["string","null"]},"effective_to":{"type":["string","null"]}},"required":["article","title","url","effective_from","effective_to"],"additionalProperties":false}},"input_evidence":{"type":"array","items":{"$ref":"#/components/schemas/TaxAssessmentEvidenceV1"}},"tax_point":{"type":["string","null"]}},"required":["schema_version","rule_set_version","legal_reviewed_on","assurance","assessment_status","missing_facts","issues","tax_legs","legal_basis","input_evidence","tax_point"],"additionalProperties":false},"TaxAssessmentEvidenceV1":{"type":"object","properties":{"id":{"type":"string","minLength":1},"kind":{"type":"string","enum":["customer_declaration","business_record","national_tax_certificate","contract","commercial_check","billing_address","ip_location","payment_location"]},"status":{"type":"string","enum":["supplied","conflicting","unavailable"]},"source_url":{"type":"string","format":"uri"},"observed_at":{"type":"string"},"effective_from":{"type":["string","null"]},"effective_to":{"type":["string","null"]},"supports":{"type":"array","items":{"type":"string","enum":["supplier_establishment","customer_establishment","customer_business_status","business_use","supply_category","exception_status","supplier_destination_presence"]}}},"required":["id","kind","status","observed_at","effective_from","effective_to","supports"],"additionalProperties":false},"TaxAssessmentInputV1":{"type":"object","properties":{"tax_point":{"type":["string","null"]},"supply_category":{"type":"string","enum":["ordinary_business_service","electronic_service","goods","live_teaching","virtual_event","real_estate","transport","unknown"]},"supplier":{"$ref":"#/components/schemas/TaxPartyV1"},"customer":{"$ref":"#/components/schemas/TaxPartyV1"},"business_use":{"type":"string","enum":["business","mixed","private","unknown"]},"supplier_has_intervening_establishment_at_destination":{"type":"string","enum":["yes","no","unknown"]},"exception_status":{"type":"string","enum":["none","applies","unknown"]},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/TaxAssessmentEvidenceV1"}}},"required":["supply_category","evidence"],"additionalProperties":false},"TaxPartyV1":{"type":"object","properties":{"legal_name":{"type":"string"},"business_status":{"type":"string","enum":["business","consumer","unknown"]},"establishment":{"type":"object","properties":{"country_code":{"type":"string","pattern":"^[A-Z]{2}$"},"territory_code":{"oneOf":[{"$ref":"#/components/schemas/TaxTerritoryCode"},{"type":"string","enum":["unknown"]}]},"role":{"type":"string","enum":["supplying_establishment","receiving_establishment","consumer_residence","registered_office","billing_address","unknown"]},"confirmed":{"type":"boolean"},"evidence_refs":{"type":"array","items":{"type":"string","minLength":1}}},"required":["country_code","territory_code","role","confirmed","evidence_refs"],"additionalProperties":false},"evidence_refs":{"type":"array","items":{"type":"string","minLength":1}},"vat_status":{"type":"string","enum":["valid","invalid","unavailable","unknown","not_checked"]}},"required":["business_status","evidence_refs"],"additionalProperties":false},"TaxTerritoryCode":{"type":"string","enum":["ES_CANARY","ES_MAINLAND_BALEARIC","AT_VAT","BE_VAT","BG_VAT","CY_VAT","CZ_VAT","DE_VAT","DK_VAT","EE_VAT","EL_VAT","GR_VAT","FI_VAT","FR_VAT","HR_VAT","HU_VAT","IE_VAT","IT_VAT","LT_VAT","LU_VAT","LV_VAT","MT_VAT","NL_VAT","PL_VAT","PT_VAT","RO_VAT","SE_VAT","SI_VAT","SK_VAT","XI_VAT","GB_VAT","CH_VAT","NO_VAT","IS_VAT","GE_VAT","RS_VAT","AL_VAT","UA_VAT","TR_VAT","ES_CEUTA","ES_MELILLA"]},"DisclosurePublicVatOnlyDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"status":{"type":"string","enum":["valid","invalid","unavailable","unknown","unsupported"],"description":"Validity confirms registration only and does not show that the number belongs to your customer."},"vat_id":{"type":"string","maxLength":8192},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0},"company":{"type":["object","null"],"properties":{"legal_name":{"type":["string","null"],"maxLength":8192},"address":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicAddress"},{"type":"null"}]},"legal_entity":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicLegalEntity"},{"type":"null"}]}},"required":["legal_name"],"additionalProperties":false},"consultation":{"$ref":"#/components/schemas/DisclosurePublicConsultation"},"e_invoicing_registration":{"$ref":"#/components/schemas/DisclosurePublicEInvoicingRegistration"},"quota":{"$ref":"#/components/schemas/ResponseQuotaPayload"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","status","vat_id","country_code","evidence","fieldTrust"],"additionalProperties":false},"DisclosurePublicConsultation":{"type":"object","properties":{"official_consultation_number":{"type":["string","null"],"maxLength":8192},"internal_receipt_id":{"type":"string","format":"uuid"},"verified_at":{"type":"string","format":"date-time"},"has_official_receipt":{"type":"boolean"},"is_audit_admissible":{"type":"boolean","enum":[false]},"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"}},"required":["official_consultation_number","internal_receipt_id","verified_at","has_official_receipt","is_audit_admissible","source"],"additionalProperties":false},"DisclosurePublicEInvoicingRegistration":{"type":"object","properties":{"system":{"type":"string","enum":["rs_sef"],"description":"Serbian Ministry of Finance e-invoicing system (SEF)."},"status":{"type":"string","enum":["registered","deleted","not_listed"]},"establishes_vat_registration":{"type":"boolean","enum":[false]},"tax_id":{"type":["string","null"],"maxLength":8192},"registration_number":{"type":["string","null"],"maxLength":8192},"legal_name":{"type":["string","null"],"maxLength":8192},"registered_from":{"type":["string","null"],"format":"date"},"deleted_on":{"type":["string","null"],"format":"date"},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["system","status","establishes_vat_registration","tax_id","registration_number","legal_name","registered_from","deleted_on","evidenceRefs"],"additionalProperties":false},"DisclosurePublicStandingDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"status":{"type":"string","enum":["valid","invalid","unavailable","unknown","unsupported"],"description":"Validity confirms registration only and does not show that the number belongs to your customer."},"vat_id":{"type":"string","maxLength":8192},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0},"company":{"type":["object","null"],"properties":{"legal_name":{"type":["string","null"],"maxLength":8192},"standing":{"type":"string","enum":["active","dissolved","in_liquidation","bankrupt","inactive","unsupported"]},"verified_against_registry":{"type":"boolean"},"registry_identifier":{"type":["string","null"],"maxLength":8192},"address":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicAddress"},{"type":"null"}]},"legal_entity":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicLegalEntity"},{"type":"null"}]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"}},"required":["legal_name","standing","verified_against_registry","evidenceRefs"],"additionalProperties":false},"components":{"$ref":"#/components/schemas/DisclosurePublicStandingComponents"},"quota":{"$ref":"#/components/schemas/ResponseQuotaPayload"},"view":{"type":"string","enum":["full","compact"]},"consultation":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicConsultation"},{"type":"null"}]},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","status","vat_id","country_code","evidence","fieldTrust"],"additionalProperties":false},"DisclosurePublicStandingComponents":{"type":"object","properties":{"schema_version":{"type":"string","enum":["canonical-standing-components-v1"]},"standing_eligibility":{"type":"string","enum":["supported","unsupported"]},"vat":{"type":"object","properties":{"operation_id":{"type":"string","format":"uuid"},"period":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"string","minLength":7,"maxLength":198,"pattern":"^trial:"}]},"startsAt":{"type":"string","format":"date-time"},"endsAt":{"type":"string","format":"date-time"}},"required":["id","startsAt","endsAt"],"additionalProperties":false},"policy_version":{"type":"string","maxLength":8192},"status":{"type":"string","enum":["completed","failed","interrupted"]},"kind":{"type":"string","enum":["vat_validation","company_verification"]},"units_charged":{"oneOf":[{"type":"number","enum":[0]},{"type":"number","enum":[1]}]},"settlement_reason":{"type":"string","enum":["completed_lookup","unavailable","unsupported","provider_error","interrupted","late_result","delivery_withheld"]}},"required":["operation_id","period","policy_version","status","kind","units_charged","settlement_reason"],"additionalProperties":false},"standing":{"type":["object","null"],"properties":{"operation_id":{"type":"string","format":"uuid"},"period":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"string","minLength":7,"maxLength":198,"pattern":"^trial:"}]},"startsAt":{"type":"string","format":"date-time"},"endsAt":{"type":"string","format":"date-time"}},"required":["id","startsAt","endsAt"],"additionalProperties":false},"policy_version":{"type":"string","maxLength":8192},"status":{"type":"string","enum":["completed","failed","interrupted"]},"kind":{"type":"string","enum":["vat_validation","company_verification"]},"units_charged":{"oneOf":[{"type":"number","enum":[0]},{"type":"number","enum":[1]}]},"settlement_reason":{"type":"string","enum":["completed_lookup","unavailable","unsupported","provider_error","interrupted","late_result","delivery_withheld"]}},"required":["operation_id","period","policy_version","status","kind","units_charged","settlement_reason"],"additionalProperties":false}},"required":["schema_version","standing_eligibility","vat","standing"],"additionalProperties":false},"VatVerifyInputV1":{"type":"object","properties":{"vat_id":{"type":"string","minLength":2,"maxLength":32,"description":"VAT number with or without country prefix (e.g. 'ESB87923822' or 'B87923822')"},"country_code":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country code (required if vat_id lacks country prefix)"},"requester_vat_id":{"type":"string","minLength":2,"maxLength":32,"description":"Optional requester VAT ID (e.g. 'DE123456789') submitted to VIES for a qualified consultation. Receipt and identity disclosure depend on the authority response; withheld details remain undisclosed. Send your organization's verified requester VAT ID: any other value gets deprecation headers and is refused from 27 December 2026. The saved requester is never applied here."},"verify_company_status":{"type":"boolean","default":false,"description":"If true, requests independently supported administrative company standing through an exact registry identifier mapping. Standing does not establish solvency or legal dissolution."},"view":{"type":"string","enum":["compact","full"],"default":"full","description":"Output view: 'compact' (status only) or 'full' (normalized address, legal form, proof)"},"mode":{"type":"string","enum":["live","mock","sandbox"],"default":"live","description":"Execution mode: 'live' (authoritative registries), 'mock', or 'sandbox'"},"order_reference":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[^\\p{Cc}\\p{Cf}]*$","description":"Your order reference, kept with the record"},"invoice_reference":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[^\\p{Cc}\\p{Cf}]*$","description":"Your invoice reference, kept with the record"},"customs_declaration_reference":{"type":"string","pattern":"^[0-9]{2}[A-Za-z]{2}[A-Za-z0-9]{14}$","description":"Customs declaration Movement Reference Number (MRN), kept with the record"},"comment":{"type":"string","minLength":1,"maxLength":500,"pattern":"^[^\\p{Cc}\\p{Cf}]*$","description":"A note kept with the record"}},"required":["vat_id"]},"CompanySearchInputV1":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":256,"description":"Company, brand or trade name, distinctive LEI/EUID, or labeled DUNS: query. Nine-digit D-U-N-S values require the typed duns criterion or DUNS: label to avoid ambiguity with national registry numbers."},"domain":{"type":"string","minLength":3,"maxLength":256,"description":"Company website or domain name (e.g. 'spotify.com')"},"country_code":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country code filter"},"company_id":{"type":"string","minLength":1,"maxLength":64,"description":"Official company registry identifier"},"lei":{"type":"string","minLength":20,"maxLength":20,"pattern":"^[A-Za-z0-9]{20}$","description":"Legal Entity Identifier for a direct reference-data lookup"},"euid":{"type":"string","minLength":1,"maxLength":160,"description":"European Unique Identifier for exact source-bound company discovery"},"duns":{"type":"string","minLength":1,"maxLength":40,"description":"D-U-N-S number for company publication discovery; issuer verification is unsupported"},"duns_source_url":{"type":"string","minLength":1,"maxLength":2048,"description":"Optional reviewed publication hint for D-U-N-S discovery"},"register":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","description":"Source-native register qualifier for an exact company identifier"},"tax_id":{"type":"string","minLength":1,"maxLength":64,"description":"Unsupported search criterion: returns identifier_binding_required (400). Use company_id with register, or query with country_code."},"vat_id":{"type":"string","minLength":1,"maxLength":64,"description":"Unsupported search criterion: returns identifier_binding_required (400). Use company_id with register, or query with country_code."},"include_vat":{"type":"boolean","description":"Deprecated alias for lookup_vat. On a name search it makes the request a VAT discovery, metered as one vat_discovery unit instead of a company search, returning each candidate's sourced VAT associations unvalidated; it does not establish VAT validity."},"lookup_vat":{"type":"boolean","default":false,"description":"On a name search, makes the request a VAT discovery, metered as one vat_discovery unit instead of a company search, and returns each candidate's VAT associations from admitted sources unvalidated. Computable national numbers alone are not projected as sourced VAT associations. Without a VAT flag a company search returns no VAT identifiers or validity."},"validate_vat":{"type":"boolean","default":false,"description":"On a name search, makes the request a VAT discovery (one vat_discovery unit) that includes at most one VAT validation against the authoritative tax register (e.g. European Commission VIES): of the single proposed VAT identifier of a single candidate. Several candidates or associations stay unvalidated; validate another identifier with a separate VAT validation."},"view":{"type":"string","enum":["compact","full"],"default":"full","description":"Output view: 'compact' or 'full'"},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5},"mode":{"type":"string","enum":["live","mock","sandbox"],"default":"live","description":"Execution mode: 'live', 'mock', or 'sandbox'"}}},"DisclosurePublicCalculationDelivery":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCalculatedFactsDelivery"},{"$ref":"#/components/schemas/DisclosurePublicGbRateCardDelivery"},{"$ref":"#/components/schemas/DisclosurePublicXiRateCardDelivery"}]},"DisclosurePublicCalculatedFactsDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"jurisdiction":{"$ref":"#/components/schemas/DisclosurePublicCalculationJurisdiction"},"rates":{"$ref":"#/components/schemas/DisclosurePublicCalculationRates"},"rate_citation_refs":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicReferenceCitation"},"minItems":1},"calculation":{"type":["object","null"],"properties":{"subtotal":{"type":"number"},"total_tax":{"type":"number"},"total_amount":{"type":"number"},"items":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicCalculationItem"},"minItems":1}},"required":["subtotal","total_tax","total_amount","items"],"additionalProperties":false},"sources":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicAnonymousReferenceSource"},"minItems":1},"quota":{"$ref":"#/components/schemas/DisclosurePublicCalculationQuota"}},"required":["schemaVersion","disclosurePolicyVersion","jurisdiction","rates","rate_citation_refs","calculation","sources","quota"],"additionalProperties":false},"DisclosurePublicCalculationJurisdiction":{"type":"object","properties":{"country_code":{"type":"string","pattern":"^[A-Z]{2}$"},"country_name":{"type":"string","minLength":1,"maxLength":200},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"detection_source":{"type":"string","enum":["country_code","domain","client_ip","default"]}},"required":["country_code","country_name","currency","detection_source"],"additionalProperties":false},"DisclosurePublicCalculationRates":{"type":"object","properties":{"standard":{"type":"number"},"reduced":{"oneOf":[{"type":"number"},{"type":"array","items":{"type":"number"},"minItems":1},{"type":"null"}]},"super_reduced":{"type":["number","null"]},"parking":{"type":["number","null"]},"zero":{"type":["number","null"]}},"required":["standard","reduced","super_reduced","parking","zero"],"additionalProperties":false},"DisclosurePublicReferenceCitation":{"type":"string","pattern":"^citation-[1-9][0-9]{0,8}$"},"DisclosurePublicCalculationItem":{"type":"object","properties":{"id":{"type":"string"},"description":{"type":"string","minLength":1,"maxLength":512},"tier":{"type":"string","enum":["standard","reduced","super_reduced","parking","zero","exempt"]},"applied_rate":{"type":"number"},"tax_amount":{"type":"number"},"gross_amount":{"type":"number"},"classification_reason":{"type":"string","enum":["Rate applied to the supplied net amount."]},"citation_refs":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicReferenceCitation"},"minItems":1}},"required":["id","description","tier","applied_rate","tax_amount","gross_amount","classification_reason","citation_refs"],"additionalProperties":false},"DisclosurePublicAnonymousReferenceSource":{"type":"object","properties":{"citation":{"$ref":"#/components/schemas/DisclosurePublicReferenceCitation"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicReferenceField"},"minItems":1,"maxItems":2},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"factReviewedAt":{"type":["string","null"],"format":"date"},"category":{"type":"string","enum":["unclassified_public_source"]},"label":{"type":"string","enum":["Public reference source"]},"name":{"type":"null"},"url":{"type":"null"}},"required":["citation","fields","disclosurePolicyVersion","factReviewedAt","category","label","name","url"],"additionalProperties":false},"DisclosurePublicReferenceField":{"type":"string","enum":["vat_rate","vat_rate_category"]},"DisclosurePublicCalculationQuota":{"type":"object","properties":{"vat_eu_queries":{"type":"object","properties":{"cost":{"type":"number","enum":[0]},"allowed":{"type":["integer","null"],"minimum":0},"used":{"type":"integer","minimum":0},"remaining":{"type":["integer","null"],"minimum":0}},"required":["cost","allowed","used","remaining"],"additionalProperties":false},"reverse_vat_lookups":{"type":"object","properties":{"cost":{"type":"number","enum":[0]},"allowed":{"type":["integer","null"],"minimum":0},"used":{"type":"integer","minimum":0},"remaining":{"type":["integer","null"],"minimum":0}},"required":["cost","allowed","used","remaining"],"additionalProperties":false},"company_searches":{"type":"object","properties":{"cost":{"type":"number","enum":[0]},"allowed":{"type":["integer","null"],"minimum":0},"used":{"type":"integer","minimum":0},"remaining":{"type":["integer","null"],"minimum":0}},"required":["cost","allowed","used","remaining"],"additionalProperties":false},"company_status_verifications":{"type":"object","properties":{"cost":{"type":"number","enum":[0]},"allowed":{"type":["integer","null"],"minimum":0},"used":{"type":"integer","minimum":0},"remaining":{"type":["integer","null"],"minimum":0}},"required":["cost","allowed","used","remaining"],"additionalProperties":false},"resets_at":{"type":"string","format":"date-time"}},"required":["vat_eu_queries","reverse_vat_lookups","company_searches","company_status_verifications","resets_at"],"additionalProperties":false},"DisclosurePublicGbRateCardDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"kind":{"type":"string","enum":["rate_card"]},"jurisdiction":{"type":"object","properties":{"country_code":{"type":"string","enum":["GB"]},"detection_source":{"type":"string","enum":["country_code"]}},"required":["country_code","detection_source"],"additionalProperties":false},"rates":{"type":"object","properties":{"standard":{"type":"number","enum":[20]},"reduced":{"type":"number","enum":[5]},"zero":{"type":"number","enum":[0]}},"required":["standard","reduced","zero"],"additionalProperties":false},"rate_citation_refs":{"type":"array","prefixItems":[{"type":"string","enum":["citation-1"]}]},"calculation":{"type":"null"},"sources":{"type":"array","prefixItems":[{"type":"object","properties":{"citation":{"type":"string","enum":["citation-1"]},"fields":{"type":"array","prefixItems":[{"type":"string","enum":["vat_rate"]},{"type":"string","enum":["vat_rate_category"]}]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"factReviewedAt":{"type":"string","enum":["2026-10-13"]},"category":{"type":"string","enum":["government_public_service"]},"name":{"type":"string","enum":["GOV.UK — VAT rates"]},"url":{"type":"string","enum":["https://www.gov.uk/vat-rates"]},"role":{"type":"string","enum":["government_publication"]},"categoryScope":{"type":"string","enum":["rate_tiers_only"]},"provisionReviewedAt":{"type":"string","enum":["2026-10-13T22:45:43Z"]},"notice":{"type":"object","properties":{"text":{"type":"string","enum":["Contains public sector information licensed under the Open Government Licence v3.0."]},"url":{"type":"string","enum":["https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"]}},"required":["text","url"],"additionalProperties":false}},"required":["citation","fields","disclosurePolicyVersion","factReviewedAt","category","name","url","role","categoryScope","provisionReviewedAt","notice"],"additionalProperties":false}]},"quota":{"$ref":"#/components/schemas/DisclosurePublicCalculationQuota"}},"required":["schemaVersion","disclosurePolicyVersion","kind","jurisdiction","rates","rate_citation_refs","calculation","sources","quota"],"additionalProperties":false},"DisclosurePublicXiRateCardDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"kind":{"type":"string","enum":["rate_card"]},"jurisdiction":{"type":"object","properties":{"country_code":{"type":"string","enum":["XI"]},"detection_source":{"type":"string","enum":["country_code"]}},"required":["country_code","detection_source"],"additionalProperties":false},"rates":{"type":"object","properties":{"standard":{"type":"number","enum":[20]},"reduced":{"type":"number","enum":[5]},"zero":{"type":"number","enum":[0]}},"required":["standard","reduced","zero"],"additionalProperties":false},"rate_citation_refs":{"type":"array","prefixItems":[{"type":"string","enum":["citation-1"]}]},"calculation":{"type":"null"},"sources":{"type":"array","prefixItems":[{"type":"object","properties":{"citation":{"type":"string","enum":["citation-1"]},"fields":{"type":"array","prefixItems":[{"type":"string","enum":["vat_rate"]},{"type":"string","enum":["vat_rate_category"]}]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"factReviewedAt":{"type":"string","enum":["2026-10-19"]},"category":{"type":"string","enum":["government_public_service"]},"name":{"type":"string","enum":["GOV.UK — VAT rates"]},"url":{"type":"string","enum":["https://www.gov.uk/vat-rates"]},"role":{"type":"string","enum":["government_publication"]},"categoryScope":{"type":"string","enum":["rate_tiers_only"]},"provisionReviewedAt":{"type":"string","enum":["2026-10-19T15:03:25Z"]},"notice":{"type":"object","properties":{"text":{"type":"string","enum":["Contains public sector information licensed under the Open Government Licence v3.0."]},"url":{"type":"string","enum":["https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"]}},"required":["text","url"],"additionalProperties":false}},"required":["citation","fields","disclosurePolicyVersion","factReviewedAt","category","name","url","role","categoryScope","provisionReviewedAt","notice"],"additionalProperties":false}]},"quota":{"$ref":"#/components/schemas/DisclosurePublicCalculationQuota"}},"required":["schemaVersion","disclosurePolicyVersion","kind","jurisdiction","rates","rate_citation_refs","calculation","sources","quota"],"additionalProperties":false},"VatCalculateInputV1":{"type":"object","properties":{"country_code":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 jurisdiction (resolved automatically if omitted)"},"client_ip":{"oneOf":[{"type":"string","format":"ip"},{"type":"string","format":"ip"}],"description":"Client IP address for geo-location lookup (fallback to CF-Connecting-IP)"},"domain":{"type":"string","minLength":3,"maxLength":256,"description":"Merchant or buyer domain TLD for geo-resolution (e.g. 'amazon.de')"},"rates_only":{"type":"boolean","default":false,"description":"If true, returns jurisdiction rate card without calculating items"},"items":{"type":"array","items":{"$ref":"#/components/schemas/VatCalculateItemInputV1"},"description":"List of products or services for itemized VAT calculation"}}},"VatCalculateItemInputV1":{"type":"object","properties":{"id":{"type":"string","description":"Optional client-provided item identifier"},"description":{"type":"string","minLength":1,"maxLength":512,"description":"Product or service description to classify tier"},"amount":{"type":"number","exclusiveMinimum":0,"description":"Net taxable amount"},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"EUR","description":"ISO 4217 three-letter currency code"}},"required":["description","amount"]},"DisclosurePublicReviewedBulkRowList":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicBulkRowDelivery"},"maxItems":100},"nextAfter":{"type":["integer","null"],"exclusiveMinimum":0}},"required":["items","nextAfter"],"additionalProperties":false},"DisclosurePublicBulkRowDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"id":{"type":"string","format":"uuid"},"jobId":{"type":"string","format":"uuid"},"rowNumber":{"type":"integer","exclusiveMinimum":0,"maximum":100000},"input":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicDeliveryInput"},{"type":"null"}]},"submitted":{"$ref":"#/components/schemas/DisclosurePublicBulkSubmitted"},"notices":{"type":"array","items":{"type":"string","enum":["VAT Tools synthetic sandbox fixture; not live authority evidence"]},"maxItems":1},"review":{"$ref":"#/components/schemas/DisclosurePublicBulkReview"},"status":{"type":"string","enum":["invalid","duplicate","pending","admitted","completed","failed","interrupted","cancelled"]},"duplicateOfRowNumber":{"type":["integer","null"],"exclusiveMinimum":0},"operationId":{"type":["string","null"],"format":"uuid"},"result":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicLegacyCompanyDelivery"},{"type":"null"}]},"publicResult":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicVerificationDelivery"},{"$ref":"#/components/schemas/DisclosurePublicResolutionDelivery"},{"$ref":"#/components/schemas/DisclosurePublicWebCompanyDelivery"},{"$ref":"#/components/schemas/DisclosurePublicIdentifierChecksDelivery"},{"$ref":"#/components/schemas/DisclosurePublicLegacyCompanyDelivery"},{"type":"null"}]},"resultState":{"type":["string","null"],"enum":["available","expired","suppressed",null]},"unitsCharged":{"oneOf":[{"type":"number","enum":[0]},{"type":"number","enum":[1]},{"type":"null"}]},"settlementReason":{"type":["string","null"],"enum":["completed_lookup","unavailable","unsupported","provider_error","interrupted","late_result","delivery_withheld",null]},"error":{"type":["object","null"],"properties":{"reason":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"},"retryable":{"type":"boolean"}},"required":["reason","retryable"],"additionalProperties":false},"validationErrors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["country_code","query","registry_id","vat_number","identifier","claims"]},"reason":{"$ref":"#/components/schemas/DisclosurePublicDisclosureReason"}},"required":["field","reason"],"additionalProperties":false},"maxItems":30},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["schemaVersion","disclosurePolicyVersion","id","jobId","rowNumber","input","status","operationId","publicResult","unitsCharged","settlementReason","createdAt","updatedAt"],"additionalProperties":false},"DisclosurePublicBulkSubmitted":{"type":"object","properties":{"reference":{"type":"string","maxLength":8192},"country_code":{"type":"string","maxLength":8192},"vat_number":{"type":"string","maxLength":8192},"registry_id":{"type":"string","maxLength":8192},"company_name":{"type":"string","maxLength":8192},"lei":{"type":"string","maxLength":8192},"eori":{"type":"string","maxLength":8192},"peppol_id":{"type":"string","maxLength":8192},"national_id_scheme":{"type":"string","maxLength":8192},"national_id":{"type":"string","maxLength":8192},"euid":{"type":"string","maxLength":8192},"duns":{"type":"string","maxLength":8192},"expected_legal_name":{"type":"string","maxLength":8192},"expected_address":{"type":"string","maxLength":8192},"dora_primary_code":{"type":"string","maxLength":8192},"dora_primary_code_type":{"type":"string","maxLength":8192},"dora_additional_code":{"type":"string","maxLength":8192},"dora_additional_code_type":{"type":"string","maxLength":8192},"dora_person_type":{"type":"string","maxLength":8192},"dora_headquarters_country":{"type":"string","maxLength":8192},"dora_name_latin":{"type":"string","maxLength":8192},"c0010":{"type":"string","maxLength":8192},"c0020":{"type":"string","maxLength":8192},"c0030":{"type":"string","maxLength":8192},"c0040":{"type":"string","maxLength":8192},"c0050":{"type":"string","maxLength":8192},"c0060":{"type":"string","maxLength":8192},"c0070":{"type":"string","maxLength":8192},"c0080":{"type":"string","maxLength":8192},"c0090":{"type":"string","maxLength":8192},"c0100":{"type":"string","maxLength":8192},"c0110":{"type":"string","maxLength":8192},"c0120":{"type":"string","maxLength":8192}},"additionalProperties":false},"DisclosurePublicBulkReview":{"type":"object","properties":{"status":{"type":"string","enum":["clear","needs_review","pending"]},"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["input_error","ambiguous","conflict","requested_record_missing","source_unavailable","unsupported","identity_unconfirmed","stale_evidence","review_age_exceeded","vat_required","failed","interrupted","cancelled","result_expired","result_suppressed","dora_identifier_required","dora_identifier_ineligible","dora_association_unverified","derived_vat_candidate_unconfirmed"]},"field":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicBulkReviewField"},{"type":"null"}]},"message":{"type":"string","enum":["Check the supplied business input.","More than one company or identifier requires selection.","Saved evidence conflicts with the requested record or supplied claim.","The requested record was not found or disclosed.","Saved evidence is unavailable for this delivery.","A requested check is unsupported or outside the permitted scope.","The supplied facts do not establish a confirmed company identity.","The saved result contains stale evidence.","Evidence exceeds the customer review age policy or its observation date is unknown.","The customer review policy requires an observed VAT identifier.","The saved row failed.","The saved row was interrupted.","The saved row was cancelled.","The retained result expired.","The retained result is suppressed.","Supply the required legal-person supplier identifier.","The supplied identifier is ineligible for this supplier review.","The supplier identifier association is unverified.","The domestic tax identifier is confirmed, but VIES did not confirm the VAT number derived from it. This can mean the number is not activated for cross-border use, is not a VAT registration, or is not yet updated in VIES; this result does not show which."]},"action":{"type":"string","enum":["check_input","select_company","retry_source","refresh_evidence","request_identifier","review_evidence","request_vat_number_from_customer"]},"evidenceRefs":{"$ref":"#/components/schemas/DisclosurePublicEvidenceReferences"},"checkedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"jurisdictionNote":{"$ref":"#/components/schemas/DisclosurePublicBulkReviewJurisdictionNote"}},"required":["code","field","message","action","evidenceRefs"],"additionalProperties":false},"maxItems":201},"evaluatedAt":{"type":"string","format":"date-time"},"policy":{"type":"object","properties":{"requireVat":{"type":"boolean","default":false},"maxObservationAgeDays":{"type":["integer","null"],"minimum":0,"maximum":36500,"default":null},"profile":{"type":"string","enum":["general","dora_ict_supplier"],"default":"general"}},"additionalProperties":false},"sourceObservedAt":{"type":"array","items":{"type":"string","format":"date-time"},"maxItems":2000},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":2000}},"required":["status","issues","evaluatedAt","policy","sourceObservedAt","sourceUrls"],"additionalProperties":false},"DisclosurePublicBulkReviewField":{"type":"string","enum":["reference","country_code","vat_number","registry_id","company_name","lei","eori","peppol_id","national_id_scheme","national_id","euid","duns","expected_legal_name","expected_address","dora_primary_code","dora_primary_code_type","dora_additional_code","dora_additional_code_type","dora_person_type","dora_headquarters_country","dora_name_latin","c0010","c0020","c0030","c0040","c0050","c0060","c0070","c0080","c0090","c0100","c0110","c0120","query","identifier","claims","company","vat","legal_name","registered_address","country","status","tax_id","vat_id","national","peppol","embedded_vat_validation"]},"PublicStaticRateDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-reference-v1"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"reviewVersion":{"type":"string","enum":["reference-review-2026-10-14-v1"]},"jurisdiction":{"type":"string","enum":["GB"]},"scope":{"type":"string","enum":["rate_tiers_only"]},"factReviewedAt":{"type":"string","enum":["2026-10-14"]},"evaluatedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"rates":{"type":"array","prefixItems":[{"type":"object","properties":{"tier":{"type":"string","enum":["standard"]},"rate":{"type":"number","enum":[20]}},"required":["tier","rate"],"additionalProperties":false},{"type":"object","properties":{"tier":{"type":"string","enum":["reduced"]},"rate":{"type":"number","enum":[5]}},"required":["tier","rate"],"additionalProperties":false},{"type":"object","properties":{"tier":{"type":"string","enum":["zero"]},"rate":{"type":"number","enum":[0]}},"required":["tier","rate"],"additionalProperties":false}]},"source":{"type":"object","properties":{"kind":{"type":"string","enum":["government"]},"name":{"type":"string","enum":["GOV.UK — VAT rates"]},"url":{"type":"string","enum":["https://www.gov.uk/vat-rates"]},"role":{"type":"string","enum":["government_publication"]},"scope":{"type":"string","enum":["rate_tiers_only"]},"notice":{"type":"string","enum":["Contains public sector information licensed under the Open Government Licence v3.0."]},"licenceUrl":{"type":"string","enum":["https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"]}},"required":["kind","name","url","role","scope","notice","licenceUrl"],"additionalProperties":false}},"required":["schemaVersion","disclosurePolicyVersion","reviewVersion","jurisdiction","scope","factReviewedAt","evaluatedAt","expiresAt","rates","source"],"additionalProperties":false},"PublicXiStaticRateDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-reference-v1"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"reviewVersion":{"type":"string","enum":["reference-review-2026-10-14-v1"]},"jurisdiction":{"type":"string","enum":["XI"]},"scope":{"type":"string","enum":["rate_tiers_only"]},"factReviewedAt":{"type":"string","enum":["2026-10-19"]},"evaluatedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"rates":{"type":"array","prefixItems":[{"type":"object","properties":{"tier":{"type":"string","enum":["standard"]},"rate":{"type":"number","enum":[20]}},"required":["tier","rate"],"additionalProperties":false},{"type":"object","properties":{"tier":{"type":"string","enum":["reduced"]},"rate":{"type":"number","enum":[5]}},"required":["tier","rate"],"additionalProperties":false},{"type":"object","properties":{"tier":{"type":"string","enum":["zero"]},"rate":{"type":"number","enum":[0]}},"required":["tier","rate"],"additionalProperties":false}]},"source":{"type":"object","properties":{"kind":{"type":"string","enum":["government"]},"name":{"type":"string","enum":["GOV.UK — VAT rates"]},"url":{"type":"string","enum":["https://www.gov.uk/vat-rates"]},"role":{"type":"string","enum":["government_publication"]},"scope":{"type":"string","enum":["rate_tiers_only"]},"notice":{"type":"string","enum":["Contains public sector information licensed under the Open Government Licence v3.0."]},"licenceUrl":{"type":"string","enum":["https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"]}},"required":["kind","name","url","role","scope","notice","licenceUrl"],"additionalProperties":false}},"required":["schemaVersion","disclosurePolicyVersion","reviewVersion","jurisdiction","scope","factReviewedAt","evaluatedAt","expiresAt","rates","source"],"additionalProperties":false},"DisclosurePublicBulkJobListDelivery":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicBulkJobDelivery"},"maxItems":100},"nextCursor":{"type":["string","null"],"maxLength":512}},"required":["items","nextCursor"],"additionalProperties":false},"PublicRecordExport":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["vat-tools-record-export-v1"]},"factsSha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"documentCheckUrl":{"type":["string","null"],"maxLength":512},"disclaimer":{"type":"string","minLength":1,"maxLength":500},"record":{"$ref":"#/components/schemas/DisclosurePublicCertificateDelivery"}},"required":["schemaVersion","factsSha256","documentCheckUrl","disclaimer","record"],"additionalProperties":false},"DisclosurePublicCertificateDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"operationId":{"type":"string","format":"uuid"},"issuedAt":{"type":"string","format":"date-time"},"vat":{"$ref":"#/components/schemas/DisclosurePublicCertificateVat"},"company":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicCompany"},{"type":"null"}]},"outcome":{"type":"string","enum":["found","valid","invalid","partial","unavailable","unsupported"]},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicEvidence"},"maxItems":1000},"fieldTrust":{"type":"array","items":{"$ref":"#/components/schemas/DisclosureFieldTrustAssessment"},"maxItems":100}},"required":["schemaVersion","disclosurePolicyVersion","operationId","issuedAt","company","outcome","evidence","fieldTrust"],"additionalProperties":false},"DisclosurePublicCertificateVat":{"type":"object","properties":{"vatId":{"type":"string","pattern":"^[A-Z]{2}[A-Z0-9+*.-]{2,16}$"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"legalName":{"type":["string","null"]},"address":{"type":["string","null"]},"observedAt":{"type":"string","format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"consultationNumber":{"type":["string","null"],"minLength":1,"maxLength":256,"description":"The authority's receipt of this request at consultationVerifiedAt, or null when none is retained. Not a claim of audit admissibility or tax exemption."},"requesterVatId":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$","description":"The requester VAT ID as supplied by the customer; not verified by VAT Tools."},"consultationVerifiedAt":{"type":["string","null"],"format":"date-time","description":"Authority observation time of the consultation; null exactly when the number is."}},"required":["vatId","countryCode","legalName","address","observedAt","retrievedAt","completedAt"],"additionalProperties":false},"PublicRecordConsultation":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["record-consultation-v1"]},"operationId":{"type":"string","format":"uuid"},"consultationNumber":{"type":["string","null"],"minLength":1,"maxLength":256},"requesterVatId":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"consultationVerifiedAt":{"type":["string","null"],"format":"date-time"},"isAuditAdmissible":{"type":"boolean","enum":[false]},"source":{"$ref":"#/components/schemas/DisclosurePublicSourceDisclosure"}},"required":["schemaVersion","operationId","consultationNumber","requesterVatId","consultationVerifiedAt","isAuditAdmissible","source"],"additionalProperties":false},"DisclosurePublicSourceCapabilitiesDelivery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["public-delivery-2026-10-13"]},"disclosurePolicyVersion":{"type":"string","enum":["government-source-disclosure-v1-2026-10-13"]},"entries":{"type":"array","items":{"$ref":"#/components/schemas/DisclosurePublicSourceCapabilityDelivery"},"maxItems":300}},"required":["schemaVersion","disclosurePolicyVersion","entries"],"additionalProperties":false},"DisclosurePublicSourceCapabilityDelivery":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"vatPrefix":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"capability":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"environment":{"type":"string","enum":["sandbox","live"]},"state":{"type":"string","enum":["supported","pipeline","unsupported"]},"availability":{"type":"string","enum":["live","guided","pipeline","unsupported"]},"sourceCategories":{"type":"array","items":{"type":"string","enum":["unclassified_public_source","company_publication","synthetic"]},"maxItems":3},"customerDelivery":{"type":"string","enum":["requires_current_admission"]},"runtime":{"type":"object","properties":{"available":{"type":"boolean"},"deepResolutionAvailable":{"type":"boolean"}},"required":["available","deepResolutionAvailable"],"additionalProperties":false}},"required":["jurisdiction","vatPrefix","capability","environment","state","availability","sourceCategories","customerDelivery","runtime"],"additionalProperties":false},"WebhookCreateEndpointResponseV1":{"type":"object","properties":{"endpoint":{"$ref":"#/components/schemas/WebhookEndpointV1"},"secret":{"type":"string","pattern":"^whsec_[A-Za-z0-9+/]{43}=$"}},"required":["endpoint","secret"],"additionalProperties":false},"WebhookEndpointV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["webhook-endpoints-v1"]},"id":{"type":"string","format":"uuid"},"environment":{"type":"string","enum":["live","sandbox"]},"url":{"type":"string","maxLength":2048,"format":"uri"},"description":{"type":["string","null"],"maxLength":256},"managedBy":{"type":"string","enum":["zapier","make","n8n","power_automate","manual"]},"eventTypes":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSubscribableEventTypeV1"},"minItems":1,"maxItems":5},"payloadSchemaVersion":{"type":"string","enum":["2026-09-01","2026-09-07"]},"status":{"type":"string","enum":["enabled","disabled"]},"disabledReason":{"type":["string","null"],"enum":["customer","gone","continuous_failure",null]},"failingSince":{"type":["string","null"],"format":"date-time"},"secretRotatedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"creatorAccessLost":{"type":"object","properties":{"at":{"type":"string","format":"date-time"},"reason":{"type":"string","enum":["removed","left","expired","suspended","role_changed"]}},"required":["at","reason"],"additionalProperties":false}},"required":["schemaVersion","id","environment","url","description","eventTypes","payloadSchemaVersion","status","disabledReason","failingSince","secretRotatedAt","createdAt","updatedAt"],"additionalProperties":false},"WebhookSubscribableEventTypeV1":{"type":"string","enum":["verification.completed","bulk_job.completed","monitor.change_observed","monitor.cannot_see","monitor.visibility_restored"]},"WebhookCreateEndpointRequestV1":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"eventTypes":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSubscribableEventTypeV1"},"minItems":1,"maxItems":5},"description":{"type":"string","maxLength":256},"managedBy":{"type":"string","enum":["zapier","make","n8n","power_automate","manual"]},"payloadSchemaVersion":{"type":"string","enum":["2026-09-01","2026-09-07"],"default":"2026-09-01"},"mode":{"type":"string","enum":["sandbox","live"]}},"required":["url","eventTypes"],"additionalProperties":false},"WebhookEndpointListResponseV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["webhook-endpoints-v1"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEndpointV1"},"maxItems":100},"nextCursor":{"type":["string","null"],"maxLength":512}},"required":["schemaVersion","items","nextCursor"],"additionalProperties":false},"WebhookUpdateEndpointRequestV1":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"eventTypes":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSubscribableEventTypeV1"},"minItems":1,"maxItems":5},"description":{"type":["string","null"],"maxLength":256},"status":{"type":"string","enum":["enabled","disabled"]}},"additionalProperties":false},"WebhookRotateSecretResponseV1":{"type":"object","properties":{"endpoint":{"$ref":"#/components/schemas/WebhookEndpointV1"},"secret":{"type":"string","pattern":"^whsec_[A-Za-z0-9+/]{43}=$"},"previousSecretExpiresAt":{"type":"string","format":"date-time"}},"required":["endpoint","secret","previousSecretExpiresAt"],"additionalProperties":false},"WebhookRotateSecretRequestV1":{"type":"object","properties":{"expirePreviousInSeconds":{"type":"integer","minimum":0,"maximum":86400,"default":86400}},"additionalProperties":false},"WebhookTestEndpointResponseV1":{"type":"object","properties":{"delivery":{"$ref":"#/components/schemas/WebhookDeliveryV1"}},"required":["delivery"],"additionalProperties":false},"WebhookDeliveryV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["webhook-deliveries-v1"]},"id":{"type":"string","format":"uuid"},"endpointId":{"type":"string","format":"uuid"},"environment":{"type":"string","enum":["live","sandbox"]},"eventId":{"type":"string","pattern":"^evt_[0-9a-f]{32}$"},"eventType":{"$ref":"#/components/schemas/WebhookEventTypeV1"},"status":{"type":"string","enum":["pending","succeeded","failed","withheld"]},"attemptCount":{"type":"integer","minimum":0,"maximum":20},"nextAttemptAt":{"type":["string","null"],"format":"date-time"},"lastAttemptAt":{"type":["string","null"],"format":"date-time"},"succeededAt":{"type":["string","null"],"format":"date-time"},"redeliveryOf":{"type":["string","null"],"format":"uuid"},"createdAt":{"type":"string","format":"date-time"}},"required":["schemaVersion","id","endpointId","environment","eventId","eventType","status","attemptCount","nextAttemptAt","lastAttemptAt","succeededAt","redeliveryOf","createdAt"],"additionalProperties":false},"WebhookEventTypeV1":{"type":"string","enum":["verification.completed","bulk_job.completed","monitor.change_observed","monitor.cannot_see","monitor.visibility_restored","webhook.test"]},"WebhookDeliveryListResponseV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["webhook-deliveries-v1"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDeliveryV1"},"maxItems":100},"nextCursor":{"type":["string","null"],"maxLength":512}},"required":["schemaVersion","items","nextCursor"],"additionalProperties":false},"WebhookDeliveryDetailV1":{"type":"object","properties":{"delivery":{"$ref":"#/components/schemas/WebhookDeliveryV1"},"attempts":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDeliveryAttemptV1"},"maxItems":20}},"required":["delivery","attempts"],"additionalProperties":false},"WebhookDeliveryAttemptV1":{"type":"object","properties":{"attempt":{"type":"integer","minimum":1,"maximum":20},"attemptedAt":{"type":"string","format":"date-time"},"durationMs":{"type":"integer","minimum":0,"maximum":60000},"responseStatus":{"type":["integer","null"],"minimum":100,"maximum":599},"errorClass":{"type":["string","null"],"enum":["timeout","connection_failed","tls_failed","target_rejected","redirect","http_error","withheld",null]},"responseSnippet":{"type":["string","null"],"maxLength":1024}},"required":["attempt","attemptedAt","durationMs","responseStatus","errorClass","responseSnippet"],"additionalProperties":false},"WebhookRecoverFailedDeliveriesResponseV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["webhook-deliveries-v1"]},"scheduled":{"type":"integer","minimum":0}},"required":["schemaVersion","scheduled"],"additionalProperties":false},"WebhookRecoverFailedDeliveriesRequestV1":{"type":"object","properties":{"since":{"type":"string","format":"date-time"}},"required":["since"],"additionalProperties":false},"WebhookRedeliverResponseV1":{"type":"object","properties":{"delivery":{"$ref":"#/components/schemas/WebhookDeliveryV1"}},"required":["delivery"],"additionalProperties":false}},"parameters":{"OperationIdempotencyKey":{"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","description":"Reuse the same key and payload after an uncertain response. Omitting it creates a new operation."},"required":false,"description":"Reuse the same key and payload after an uncertain response. Omitting it creates a new operation.","name":"idempotency-key","in":"header"},"Webhook1":{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query","example":"sandbox"},"Webhook2":{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},"Webhook3":{"schema":{"type":"string","minLength":1,"maxLength":512},"required":false,"name":"cursor","in":"query"},"Webhook4":{"schema":{"type":"string","format":"uuid"},"required":true,"name":"endpointId","in":"path","example":"00000000-0000-4000-8000-000000000006"},"Webhook5":{"schema":{"type":"string","format":"uuid"},"required":true,"name":"deliveryId","in":"path","example":"00000000-0000-4000-8000-000000000006"}},"responses":{"PublicError400":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"INVALID_REQUEST","message":"Check the request fields and their limits.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicErrorBody400"}}}},"PublicError401":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"UNAUTHORIZED","message":"A valid account session or API key is required.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicErrorBody401"}}}},"PublicError403":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"SCOPE_FORBIDDEN","message":"This API key does not grant the required permission.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicErrorBody403"}}}},"PublicError404":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"WEBHOOK_ENDPOINT_NOT_FOUND","message":"No webhook endpoint with this ID exists in this environment.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicErrorBody404"}}}},"PublicError406":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"PUBLIC_DELIVERY_UNAVAILABLE","message":"Public delivery unavailable.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicHttpError"}}}},"PublicError409":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"IDEMPOTENCY_CONFLICT","message":"This idempotency key was already used with a different request.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicErrorBody409"}}}},"PublicError410":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"PUBLIC_DELIVERY_UNAVAILABLE","message":"Public delivery unavailable.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicHttpError"}}}},"PublicError413":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"PUBLIC_DELIVERY_UNAVAILABLE","message":"Public delivery unavailable.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicHttpError"}}}},"PublicError415":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"PUBLIC_DELIVERY_UNAVAILABLE","message":"Public delivery unavailable.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicHttpError"}}}},"PublicError422":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"PUBLIC_DELIVERY_UNAVAILABLE","message":"Public delivery unavailable.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicHttpError"}}}},"PublicError429":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"example":{"error":{"code":"EMAIL_CODE_RATE_LIMITED","message":"Wait a moment before asking for another code.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicErrorBody429"}}}},"PublicError429DiscoveryRateLimited":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"example":{"error":{"code":"EMAIL_CODE_RATE_LIMITED","message":"Wait a moment before asking for another code.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicErrorBody429Discovery"}}}},"PublicError429RateLimited":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"example":{"error":{"code":"EMAIL_CODE_RATE_LIMITED","message":"Wait a moment before asking for another code.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicErrorBody429"}}}},"PublicError500":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"example":{"error":{"code":"PUBLIC_DELIVERY_UNAVAILABLE","message":"Public delivery unavailable.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicHttpError"}}}},"PublicError503":{"description":"Controlled public error. The status carries the meaning; see the code and fixed message.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"example":{"error":{"code":"REFERENCES_UNCERTAIN","message":"The references could not be confirmed. Retry with the same idempotency key.","request_id":"6f1c2b9e-3a4d-4c8e-9b7a-5d2e1f0a8c34"}},"schema":{"$ref":"#/components/schemas/DisclosurePublicErrorBody503"}}}}}},"paths":{"/v1/company-identifiers/check":{"post":{"operationId":"checkCompanyIdentifiersV1","tags":["Company identity"],"summary":"Check supplied company identifiers","description":"Exact LEI, national identifiers, Finland FIFPRO EUID, reviewed Norway/UK company-published D-U-N-S associations, EU/XI/GB EORI and Peppol participant checks using free public sources. D-U-N-S requires a reviewed publication URL and does not verify issuer assignment. Other EUID namespaces remain unsupported for exact lookup; secondary identifiers retain their own source evidence. Country scopes the supplied company claim; identifier issuer and receiving unit may differ. Results preserve unavailable or undisclosed sources, identity discrepancies, observation time and saved replay. Uses one company-search unit when at least one requested source establishes a definitive result.","security":[{"DeveloperKey":["company:search"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country_code":{"type":"string","enum":["AT","BE","BG","HR","CY","CZ","DK","EE","FI","FR","DE","GR","HU","IE","IT","LV","LT","LU","MT","NL","PL","PT","RO","SK","SI","ES","SE","NO","IS","LI","GB","CH","XI","EL","GE","RS","AL","UA","TR"]},"lei":{"type":"string","minLength":1,"maxLength":20},"eori":{"type":"string","minLength":1,"maxLength":32},"peppol_id":{"type":"string","minLength":1,"maxLength":240},"national_id":{"type":"object","properties":{"scheme":{"type":"string","enum":["no.orgnr","fr.siren","fr.siret","gb.crn","ch.uid","de.hrb","es.nif","it.cf","nl.kvk","be.kbo","at.fn","pl.krs","pl.nip","cz.ico","sk.ico","se.orgnr","dk.cvr","fi.ytunnus","ie.cro","pt.nipc","ro.cui","gr.afm","gr.gemi","hu.adoszam","bg.eik","hr.oib","si.maticna","lt.jar","lv.regnr","ee.registrikood","lu.rcs","cy.he","mt.mbr","xi.crn","is.kennitala","ge.id","rs.mb","rs.pib","al.nipt","ua.edrpou","tr.mersis","tr.vkn"]},"value":{"type":"string","minLength":1,"maxLength":80}},"required":["scheme","value"],"additionalProperties":false},"euid":{"type":"string","minLength":1,"maxLength":240},"duns":{"type":"string","minLength":1,"maxLength":32},"duns_source_url":{"type":"string","minLength":1,"maxLength":2048},"expected_legal_name":{"type":"string","minLength":1,"maxLength":240},"mode":{"type":"string","enum":["live"],"default":"live"}},"required":["country_code"],"additionalProperties":false},"example":{"country_code":"FR","euid":"FRSANDBOX.100000001","expected_legal_name":"SYNTHETIC ATELIER EXEMPLE SAS","mode":"live"}}}},"responses":{"200":{"description":"Saved source-scoped identifier observations","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicIdentifierChecksDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid input, authorization, admission or saved result unavailable"},"401":{"$ref":"#/components/responses/PublicError401","description":"Invalid input, authorization, admission or saved result unavailable"},"403":{"$ref":"#/components/responses/PublicError403","description":"Invalid input, authorization, admission or saved result unavailable"},"409":{"$ref":"#/components/responses/PublicError409","description":"Invalid input, authorization, admission or saved result unavailable"},"410":{"$ref":"#/components/responses/PublicError410","description":"Invalid input, authorization, admission or saved result unavailable"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Invalid input, authorization, admission or saved result unavailable"},"503":{"$ref":"#/components/responses/PublicError503","description":"Invalid input, authorization, admission or saved result unavailable"}}}},"/v1/validations":{"post":{"operationId":"createPublicVatValidation","tags":["VAT validation"],"summary":"Validate a VAT registration with canonical evidence","description":"Returns the versioned public verification envelope, including authority scope, freshness, evidence and usage settlement.","security":[{"DeveloperKey":["vat:validate"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVatValidationInput"},"example":{"countryCode":"DE","vatNumber":"100","mode":"sandbox"}}}},"responses":{"200":{"description":"Saved VAT validation projected into the canonical public envelope","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicVerificationDelivery"},"example":{"schemaVersion":"public-delivery-2026-10-13","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","operation":{"id":"00000000-0000-4000-8000-000000000001","kind":"vat_validation","status":"completed","environment":"sandbox","createdAt":"2026-10-13T12:00:00.000Z","completedAt":"2026-10-13T12:00:00.000Z","replayed":false},"subject":{"vatRegistration":{"taxJurisdiction":"DE","vatPrefix":"DE","vatIdentifier":"100","authorityScope":"vat_registration"}},"usage":{"meter":"vat_validation","unitsCharged":1,"settlementReason":"completed"},"evidence":[{"id":"evidence-1","source":{"name":null,"url":null,"evidenceRef":"evidence-1","fields":["vat_validity","tax_id","legal_name","address"],"observedAt":"2026-10-13T12:00:00.000Z","retrievedAt":"2026-10-13T12:00:00.000Z","sourceRecordUpdatedAt":null,"datasetPublishedAt":null,"datasetImportedAt":null,"datasetEffectiveAt":null,"category":"synthetic","label":"Synthetic evidence"},"subject":{"taxJurisdiction":"DE","vatPrefix":"DE","vatIdentifier":"100","authorityScope":"vat_registration","kind":"vat_registration"},"environment":"sandbox","attemptedAt":"2026-10-13T12:00:00.000Z","servedAt":"2026-10-13T12:00:01.000Z","completion":"complete","warnings":[]}],"staleEvidence":[],"claims":[{"id":"claim-1","type":"vat_validity","outcome":"unknown","effectiveFrom":null,"effectiveTo":null,"value":true,"expectedValue":true,"evidenceRefs":["evidence-1"],"reasons":["partial_data_correlation"]}],"relationships":[],"conflicts":[],"issues":[],"fieldTrust":[{"field":"vat_validity","score":null,"assessment":"unassessed","modelVersion":"field-trust-v1","assessedAt":"2026-10-13T12:00:01.000Z","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","observedPublisherGroups":0,"effectiveCorrelationGroups":0,"provenIndependentLineages":0,"evidenceRefs":[],"reasons":["insufficient_metadata"]},{"field":"tax_id","score":null,"assessment":"unassessed","modelVersion":"field-trust-v1","assessedAt":"2026-10-13T12:00:01.000Z","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","observedPublisherGroups":0,"effectiveCorrelationGroups":0,"provenIndependentLineages":0,"evidenceRefs":[],"reasons":["insufficient_metadata"]},{"field":"legal_name","score":null,"assessment":"unassessed","modelVersion":"field-trust-v1","assessedAt":"2026-10-13T12:00:01.000Z","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","observedPublisherGroups":0,"effectiveCorrelationGroups":0,"provenIndependentLineages":0,"evidenceRefs":[],"reasons":["insufficient_metadata"]},{"field":"address","score":null,"assessment":"unassessed","modelVersion":"field-trust-v1","assessedAt":"2026-10-13T12:00:01.000Z","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","observedPublisherGroups":0,"effectiveCorrelationGroups":0,"provenIndependentLineages":0,"evidenceRefs":[],"reasons":["insufficient_metadata"]}],"result":{"kind":"vat_validation","outcome":"valid","vatNumber":"DE100","name":"SYNTHETIC EXAMPLE COMPANY — NOT A REAL BUSINESS","address":"100 Sandbox Street — fictional address","evidenceRefs":["evidence-1"]}}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request, freshness policy or source capability"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, unfinished or interrupted operation"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Request rate or monthly allowance exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"No successful save could be confirmed"}}}},"/v1/company-searches":{"post":{"operationId":"createPublicCompanySearch","tags":["Company identity"],"summary":"Search a certified company source","description":"Returns sourced candidates with registry-qualified identities and an explicit resolution boundary.","security":[{"DeveloperKey":["company:search"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanySearchInput"},"example":{"countryCode":"FR","query":"synthetic atelier exemple","mode":"sandbox","limit":5}}}},"responses":{"200":{"description":"Saved company search projected into the canonical public envelope","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicVerificationDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request, freshness policy or source capability"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, unfinished or interrupted operation"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Request rate or monthly allowance exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"No successful save could be confirmed"}}}},"/v1/company-resolutions":{"post":{"operationId":"createPublicCompanyResolution","tags":["Company identity"],"summary":"Resolve a company and its VAT registration through reviewed fallbacks","description":"Runs the jurisdiction plan through official sources, SERP discovery, reviewed retrieval and independent VAT validation. Locator results remain separate from claim evidence. Resolving a company's VAT registration from its name is a VAT discovery; while this delivery is withheld, a new resolution is refused before any reservation or source work and only saved resolutions replay. A reviewed re-admission settles it as one vat_discovery unit.","security":[{"DeveloperKey":["company:search"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyResolutionInputV2"},"example":{"countryCode":"FR","query":"synthetic atelier exemple","mode":"live","limit":5}}}},"responses":{"200":{"description":"Saved company resolution with field evidence, source trail and VAT validation","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicOperationPayload"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request, freshness policy or source capability"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, unfinished or interrupted operation"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Request rate or monthly allowance exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"No successful save could be confirmed"}}}},"/v1/company-web-searches":{"post":{"operationId":"createPublicCompanyWebSearch","tags":["VAT discovery"],"summary":"Discover company VAT registrations from public web sources (VAT discovery)","description":"A VAT discovery started from a company name or website. Searches public company records and independently retrieved public pages through 28 jurisdiction paths, including a source-backed XI VAT territory path, and returns each candidate's national VAT registration and, with validateVat, VIES checks. FR, DK, CY, LV, LT, LU, IS, CZ and CH consult anonymous official name sources first; Luxembourg's official source covers annual-deposit filers only. Search excerpts are locators, not company facts. Source claims, national VAT registration and VIES checks are returned separately; European Commission VIES is not applicable to GB, IS or CH. Homonyms remain ambiguous even when the result limit hides additional candidates. A new request settles as one vat_discovery unit, never a company search unit; an exhausted discovery allowance returns 429 QUOTA_EXCEEDED for the vat_discovery meter. A web search saved before this metering replays under its original receipt at no charge. While this delivery is withheld, a new request is refused before any reservation or source work. This route does not replace exact registry verification or establish nationwide coverage.","security":[{"DeveloperKey":["company:search"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyWebSearchInputV2"},"example":{"query":"SYNTHETIC ATELIER EXEMPLE SAS","countryCode":"FR","includeVat":true,"mode":"live","limit":5}}}},"responses":{"200":{"description":"Saved company web search with reconciled company profile, candidate matches and source reconciliation basis","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicOperationPayload"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request, freshness policy or source capability"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, unfinished or interrupted operation"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429DiscoveryRateLimited","description":"Request rate or monthly allowance exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"No successful save could be confirmed"}}}},"/v1/company-web-searches/capabilities":{"get":{"operationId":"getPublicCompanyWebSearchCapabilities","tags":["Capabilities"],"summary":"List executable public-source VAT discovery paths","description":"Lists implemented country paths and configured runtime availability. These paths return source-scoped public observations and separate VIES checks; this is not national-register certification or nationwide completeness. Availability describes configuration, not an instantaneous upstream health check.","security":[],"responses":{"200":{"description":"Configured public-source search paths","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicWebSearchCapabilitiesDelivery"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"}}}},"/v1/company-web-verifications":{"post":{"operationId":"createPublicCompanyWebVerification","tags":["Company identity"],"summary":"Recheck one saved public-source company candidate","description":"Refreshes independently retrieved source records for one candidate in a retained company-web-search result. The full published legal name and original company or tax identifier must match. Published addresses and VAT claims remain separate, and a re-check makes no VIES attempt; standing and registered address remain unknown. This source-scoped result does not certify nationwide register coverage. Fresh delivery is withheld until a reviewed admission exists: after any exact replay, a new re-check is refused with 503 PUBLIC_DELIVERY_UNAVAILABLE before the saved search is loaded, a unit is reserved or any source is called. An exact replay of a saved re-check returns its stored delivery at no charge.","security":[{"DeveloperKey":["company:verify"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyWebVerificationInputV2"},"example":{"searchOperationId":"00000000-0000-4000-8000-000000000002","candidateIndex":0,"mode":"live","claims":{"legalName":"SYNTHETIC ATELIER EXEMPLE SAS"}}}}},"responses":{"200":{"description":"Saved source-scoped verification and fresh VAT checks","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicOperationPayload"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request, freshness policy or source capability"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, unfinished or interrupted operation"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Request rate or monthly allowance exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"No successful save could be confirmed"}}}},"/v1/product-capabilities":{"get":{"operationId":"listProductCapabilities","tags":["Capabilities"],"summary":"List live company search, verification and VAT discovery delivery methods","description":"Configured product availability, including public-source delivery. The company web search returns VAT registration and VIES checks, so it is listed as VAT discovery, never as company search. Native registry certifications remain in the source-capability catalogue. Availability is derived from current customer-delivery admission: an operation is reported as live only when a configured method is also admitted for live customer delivery.","responses":{"200":{"description":"Source-scoped product capability records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicProductCapabilitiesDelivery"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}}}}},"/v1/company-verifications":{"post":{"operationId":"createPublicCompanyVerification","tags":["Company identity"],"summary":"Verify a registry-qualified legal entity","description":"Looks up one explicit jurisdiction, register and registry identifier, then returns source facts and claim comparisons separately.","security":[{"DeveloperKey":["company:verify"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyVerificationInput"},"example":{"countryCode":"FR","register":"vat-tools-sandbox","registryId":"100000001","mode":"sandbox","claims":{"legalName":"SYNTHETIC ATELIER EXEMPLE SAS","status":"active"}}}}},"responses":{"200":{"description":"Saved company verification projected into the canonical public envelope","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicVerificationDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request, freshness policy or source capability"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, unfinished or interrupted operation"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Request rate or monthly allowance exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"No successful save could be confirmed"}}}},"/v1/company-vat-discoveries":{"post":{"operationId":"createPublicCompanyVatDiscovery","tags":["VAT discovery"],"summary":"Discover sourced VAT associations for a legal entity","description":"Verifies one registry-qualified entity, retains every sourced VAT association and reports an optional VAT authority check independently.","security":[{"DeveloperKey":["vat:discover"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyVatDiscoveryInput"},"example":{"countryCode":"FR","register":"vat-tools-sandbox","registryId":"100000001","mode":"sandbox","validateVat":true}}}},"responses":{"200":{"description":"Saved VAT discovery projected into the canonical public envelope","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicVerificationDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request, freshness policy or source capability"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, unfinished or interrupted operation"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Request rate or monthly allowance exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"No successful save could be confirmed"}}}},"/v1/company-searches/{searchOperationId}/selection":{"post":{"operationId":"selectPublicCompanySearchCandidate","tags":["Company identity"],"summary":"Persist an operator-selected company-search candidate","description":"Creates one immutable, organization- and environment-scoped selection event for an evidence-backed candidate in an existing completed company search or guided company resolution. Locator-only discovery leads must first be retrieved from an authority source. Requires company search permission.","security":[{"DeveloperKey":["company:search"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"searchOperationId","in":"path","example":"00000000-0000-4000-8000-000000000002"},{"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","description":"Required. Reuse this key with the identical operation and candidate after an uncertain response."},"required":true,"description":"Required. Reuse this key with the identical operation and candidate after an uncertain response.","name":"idempotency-key","in":"header"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchCandidateSelectionInputV1"},"example":{"mode":"sandbox","candidate":{"jurisdiction":"FR","register":"vat-tools-sandbox","registryId":"100000001"}}}}},"responses":{"200":{"description":"Existing immutable candidate selection","headers":{"Idempotency-Key":{"description":"The required key for replaying this exact selection.","schema":{"type":"string"}},"X-Selection-Id":{"description":"The immutable candidate-selection event ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered the existing immutable selection.","schema":{"type":"string","enum":["true","false"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicSelectionReceiptDelivery"}}}},"201":{"description":"New immutable candidate selection","headers":{"Idempotency-Key":{"description":"The required key for replaying this exact selection.","schema":{"type":"string"}},"X-Selection-Id":{"description":"The immutable candidate-selection event ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered the existing immutable selection.","schema":{"type":"string","enum":["true","false"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicSelectionReceiptDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid operation ID, idempotency key or strict request body"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, permission or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"Completed company search or selected candidate not found in this scope"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict or this search already has a selection"},"410":{"$ref":"#/components/responses/PublicError410","description":"The company-search result expired or was source-suppressed"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"The company search or selection could not be confirmed"}}}},"/v1/verifications":{"get":{"operationId":"listPublicVerificationsV1","tags":["Records and history"],"summary":"List canonical verification responses","description":"Returns current-policy public projections of retained responses in stable newest-first order for one organization environment. Defaults to V1; explicit V2 includes distinct exact registry and source-scoped public observations under current retained-review policy, and live company searches in their anonymous-category view. Evidence servedAt is refreshed for delivery. Unavailable retained V2 records are omitted; legacy runs are never reconstructed. V1 also lists POST /v1/vat/verify runs as vat_validation records; a run the current policy cannot deliver is skipped.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"string","enum":["2026-09-01","2026-09-07"]},"required":false,"name":"schemaVersion","in":"query"},{"schema":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"required":false,"name":"kind","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"$ref":"#/components/schemas/PublicVerificationHistoryCursorV1"},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"V1 or company observation V2 history page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicDeliveryHistory"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid query or cursor"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"History or a durable response snapshot is unavailable"}}}},"/v1/verifications/{operationId}":{"get":{"operationId":"getPublicVerificationV1","tags":["Records and history"],"summary":"Get one canonical verification response","description":"Returns a current-policy public projection of the immutable saved original within the authenticated organization environment. Defaults to V1; explicit V2 includes distinct exact registry and source-scoped public observations under current retained-review policy. Evidence servedAt is refreshed for delivery. V1 also serves POST /v1/vat/verify runs as vat_validation records.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"operationId","in":"path","example":"00000000-0000-4000-8000-000000000001"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"string","enum":["2026-09-01","2026-09-07"]},"required":false,"name":"schemaVersion","in":"query"}],"responses":{"200":{"description":"Current-policy public projection of a retained V1 or V2 original","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicOperationPayload"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid operation identifier or environment"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No completed verification exists in this organization environment"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"History or the durable response snapshot is unavailable"}}}},"/v1/verifications/{operationId}/annotations":{"get":{"operationId":"listRecordAnnotationsV1","tags":["Records and history"],"summary":"List a VAT record's reference history","description":"Returns the references given at creation and every later change, oldest first, with actor and time. A record created without references has an empty history. The verification itself never changes.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"operationId","in":"path","example":"00000000-0000-4000-8000-000000000001"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"Reference history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicRecordAnnotations"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid operation identifier, environment or references"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No completed VAT verification exists in this organization environment"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"503":{"$ref":"#/components/responses/PublicError503","description":"Annotations are temporarily unavailable"}}},"post":{"operationId":"appendRecordAnnotationV1","tags":["Records and history"],"summary":"Change a VAT record's references","description":"Appends a full new set of references (null clears a field). Earlier entries and the original verification never change. Performs no source lookup or charge.","security":[{"DeveloperKey":["vat:validate"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"operationId","in":"path","example":"00000000-0000-4000-8000-000000000001"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordReferences"},"example":{"order_reference":"SANDBOX-ORDER-1","invoice_reference":"SANDBOX-INVOICE-1","customs_declaration_reference":null,"comment":"Synthetic sandbox annotation."}}}},"responses":{"201":{"description":"Reference history after the change","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicRecordAnnotations"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid operation identifier, environment or references"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No completed VAT verification exists in this organization environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Concurrent change or change limit reached"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"503":{"$ref":"#/components/responses/PublicError503","description":"Annotations are temporarily unavailable"}}}},"/v1/counterparties":{"get":{"operationId":"listCounterpartiesV1","tags":["Counterparties"],"summary":"List counterparties","description":"One row per VAT identifier this organization environment has checked, newest check first, with the current-policy public projection of the latest retained record. Records removed by retention drop out. Performs no source lookup or charge.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":256},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Counterparty page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCounterpartyPage"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid query or cursor"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"503":{"$ref":"#/components/responses/PublicError503","description":"Counterparties are temporarily unavailable"}}}},"/v1/monitors":{"post":{"operationId":"createMonitorV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:write"]},{"AccountSession":[]}],"summary":"Create a monitor","description":"Watches one VAT or company registry identifier on a daily, weekly or monthly cadence. Facts default to the VAT status, or to a company's legal status, insolvency and legal name. The first run records a baseline; later runs record a change only when two definitive observations differ. Runs perform no charged check. An optional Idempotency-Key returns the stored monitor for the same body and 409 IDEMPOTENCY_CONFLICT for a different one. A company fact no register serves is MONITOR_FACT_UNAVAILABLE.","parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorCreateRequestV1"},"example":{"subject":{"kind":"vat_id","countryCode":"DE","vatNumber":"100"},"watchedFacts":["vat_status"],"cadence":"weekly","mode":"sandbox"}}}},"responses":{"201":{"description":"The created monitor, or the stored one on an idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request, subject or watched facts (MONITOR_SUBJECT_INVALID, MONITOR_FACT_NOT_WATCHABLE, MONITOR_FACT_UNAVAILABLE)"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied, or the plan does not include monitors or this cadence (MONITORING_NOT_IN_PLAN, MONITOR_CADENCE_NOT_IN_PLAN)"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, a monitor for this subject already exists, or the plan's monitor slots are all in use (IDEMPOTENCY_CONFLICT, MONITOR_ALREADY_EXISTS, MONITOR_LIMIT_REACHED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"The request body is too large"},"415":{"$ref":"#/components/responses/PublicError415","description":"Send the request as application/json"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}},"get":{"operationId":"listMonitorsV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:read"]},{"AccountSession":[]}],"summary":"List monitors","description":"Newest first, with an opaque cursor for the next page. Deleted monitors are not listed.","parameters":[{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"string","enum":["active","paused","cannot_see"]},"required":false,"name":"state","in":"query"},{"schema":{"type":"string","enum":["vat_id","company"]},"required":false,"name":"subjectKind","in":"query"},{"schema":{"type":"string","pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"required":false,"name":"counterpartyVatId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":512},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Monitor page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorListResponseV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid query, identifier or cursor"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}}},"/v1/monitors/{monitorId}":{"get":{"operationId":"getMonitorV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:read"]},{"AccountSession":[]}],"summary":"Get a monitor","description":"A deleted monitor is returned with state deleted until it expires.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"monitorId","in":"path","example":"00000000-0000-4000-8000-000000000004"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"The monitor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid query or identifier"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No monitor with this ID exists in this environment (MONITOR_NOT_FOUND)"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}},"patch":{"operationId":"updateMonitorV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:write"]},{"AccountSession":[]}],"summary":"Change a monitor's cadence or watched facts","description":"A newly watched fact starts with a baseline. A cadence change is checked against the plan like a create.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"monitorId","in":"path","example":"00000000-0000-4000-8000-000000000004"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorUpdateRequestV1"},"example":{"cadence":"daily"}}}},"responses":{"200":{"description":"The updated monitor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or identifier"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied, or the plan does not include this cadence (MONITORING_NOT_IN_PLAN, MONITOR_CADENCE_NOT_IN_PLAN)"},"404":{"$ref":"#/components/responses/PublicError404","description":"No monitor with this ID exists in this environment (MONITOR_NOT_FOUND)"},"409":{"$ref":"#/components/responses/PublicError409","description":"The monitor was deleted, or the plan's monitor slots are all in use (MONITOR_DELETED, MONITOR_LIMIT_REACHED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"The request body is too large"},"415":{"$ref":"#/components/responses/PublicError415","description":"Send the request as application/json"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}},"delete":{"operationId":"deleteMonitorV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:write"]},{"AccountSession":[]}],"summary":"Delete a monitor","description":"Stops the monitor and frees its slot. Deleting a deleted monitor succeeds. Its observed changes stay readable until they expire.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"monitorId","in":"path","example":"00000000-0000-4000-8000-000000000004"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"responses":{"204":{"description":"The monitor is deleted","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid query or identifier"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No monitor with this ID exists in this environment (MONITOR_NOT_FOUND)"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}}},"/v1/monitors/{monitorId}/pause":{"post":{"operationId":"pauseMonitorV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:write"]},{"AccountSession":[]}],"summary":"Pause a monitor","description":"Stops the schedule. Pausing a paused monitor returns it unchanged.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"monitorId","in":"path","example":"00000000-0000-4000-8000-000000000004"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"The monitor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or identifier"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied, or the plan does not include this cadence (MONITORING_NOT_IN_PLAN, MONITOR_CADENCE_NOT_IN_PLAN)"},"404":{"$ref":"#/components/responses/PublicError404","description":"No monitor with this ID exists in this environment (MONITOR_NOT_FOUND)"},"409":{"$ref":"#/components/responses/PublicError409","description":"The monitor was deleted, or the plan's monitor slots are all in use (MONITOR_DELETED, MONITOR_LIMIT_REACHED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"The request body is too large"},"415":{"$ref":"#/components/responses/PublicError415","description":"Send the request as application/json"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}}},"/v1/monitors/{monitorId}/resume":{"post":{"operationId":"resumeMonitorV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:write"]},{"AccountSession":[]}],"summary":"Resume a monitor","description":"Restarts the schedule if the plan has room for the monitor. Resuming an active monitor returns it unchanged.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"monitorId","in":"path","example":"00000000-0000-4000-8000-000000000004"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"The monitor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or identifier"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied, or the plan does not include this cadence (MONITORING_NOT_IN_PLAN, MONITOR_CADENCE_NOT_IN_PLAN)"},"404":{"$ref":"#/components/responses/PublicError404","description":"No monitor with this ID exists in this environment (MONITOR_NOT_FOUND)"},"409":{"$ref":"#/components/responses/PublicError409","description":"The monitor was deleted, or the plan's monitor slots are all in use (MONITOR_DELETED, MONITOR_LIMIT_REACHED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"The request body is too large"},"415":{"$ref":"#/components/responses/PublicError415","description":"Send the request as application/json"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}}},"/v1/monitor-changes":{"get":{"operationId":"listMonitorChangesV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:read"]},{"AccountSession":[]}],"summary":"List observed changes","description":"Newest first, with an opaque cursor for the next page. A change compares two definitive observations of one fact and cites the government service that published each value.","parameters":[{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"string","format":"uuid"},"required":false,"name":"monitorId","in":"query"},{"schema":{"$ref":"#/components/schemas/MonitorWatchedFactV1"},"required":false,"name":"fact","in":"query"},{"schema":{"type":"string","pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"required":false,"name":"counterpartyVatId","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"detectedFrom","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"detectedTo","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":512},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Observed change page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorObservedChangeListResponseV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid query, identifier or cursor"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}}},"/v1/monitor-changes/export":{"get":{"operationId":"exportMonitorChangesV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:read"]},{"AccountSession":[]}],"summary":"Export observed changes as CSV","description":"The list filters without paging: at most the newest 10,000 changes, so narrow a larger range with detectedFrom and detectedTo. Every cell is quoted and formula-leading text is escaped. Source columns name government services only.","parameters":[{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"string","format":"uuid"},"required":false,"name":"monitorId","in":"query"},{"schema":{"$ref":"#/components/schemas/MonitorWatchedFactV1"},"required":false,"name":"fact","in":"query"},{"schema":{"type":"string","pattern":"^[A-Z]{2}[A-Z0-9+*]{1,32}$"},"required":false,"name":"counterpartyVatId","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"detectedFrom","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"detectedTo","in":"query"}],"responses":{"200":{"description":"UTF-8 CSV with a header row, in the column order of the monitor-changes-csv-v1 layout","content":{"text/csv":{"schema":{"type":"string"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid query, identifier or cursor"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}}},"/v1/monitor-changes/{changeId}":{"get":{"operationId":"getMonitorChangeV1","tags":["Monitors"],"security":[{"DeveloperKey":["monitors:read"]},{"AccountSession":[]}],"summary":"Get an observed change","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"changeId","in":"path","example":"00000000-0000-4000-8000-000000000005"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"The observed change","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorObservedChangeV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid query or identifier"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No observed change with this ID exists in this environment (MONITOR_CHANGE_NOT_FOUND)"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Too many requests"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Monitoring is unavailable: switched off, not enabled for this subject family or environment, or not deliverable under the disclosure policy"}}}},"/v1/organization/requester-vat":{"get":{"operationId":"getRequesterDefaultV1","tags":["Account"],"summary":"Read the organization's default requester VAT ID","description":"Includes its verification state, method and last nightly revalidation.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"responses":{"200":{"description":"Current default","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequesterDefaultView"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid requester VAT ID"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization administrator access denied"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request too large"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON required"},"503":{"$ref":"#/components/responses/PublicError503","description":"Requester default temporarily unavailable"}}},"put":{"operationId":"replaceRequesterDefaultV1","tags":["Account"],"summary":"Set or clear the organization's default requester VAT ID","description":"Owners and admins only. Saving checks the requester ID with European Commission VIES in your own name: it is verified when the registered name agrees with `billing_entity_name`, or, when VIES withholds the name, by `member_attestation` from a member with billing access. A check run with it keeps this ID and any consultation number on that record, its certificate and its exports.","security":[{"AccountSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequesterDefaultReplace"},"example":{"requester_vat_id":"DE100"}}}},"responses":{"200":{"description":"Saved default","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequesterDefaultView"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid requester VAT ID"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization administrator access denied"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request too large"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON required"},"503":{"$ref":"#/components/responses/PublicError503","description":"Requester default temporarily unavailable"}}}},"/v1/verifications/{operationId}/company-evidence":{"get":{"operationId":"exportSavedCompanyEvidenceV1","tags":["Records and history"],"summary":"Download one retained company evidence record","description":"Returns the permitted public projection of the retained original in JSONL or CSV, including original source dates and historical usage. Delivery charges zero operation units and performs no source work; a live request consumes one shared incoming-request slot. Requires history:read. Current retention and exact source delivery policy are checked before any bytes are sent.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"operationId","in":"path","example":"00000000-0000-4000-8000-000000000001"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"string","enum":["2026-09-01","2026-09-07","canonical-company-2026-09-30"]},"required":true,"name":"schemaVersion","in":"query","example":"canonical-company-2026-09-30"},{"schema":{"type":"string","enum":["jsonl","csv"]},"required":true,"name":"format","in":"query","example":"jsonl"}],"responses":{"200":{"description":"One projected saved company evidence record as an attachment","content":{"application/x-ndjson":{"schema":{"type":"string"}},"text/csv":{"schema":{"type":"string"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid path or query"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No completed saved response of this schema in this organization environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Selection required or profile/source export unavailable"},"410":{"$ref":"#/components/responses/PublicError410","description":"Saved evidence expired or was suppressed"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Incoming request limit reached"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"Saved evidence, retention or request admission cannot be confirmed"}}}},"/v1/companies":{"get":{"operationId":"getCompaniesV1","tags":["Company identity"],"summary":"Search Certified Company Sources","description":"Searches a specified jurisdiction through the certified country catalogue. Native name search returns candidates without silently selecting an entity. Only unambiguous authority-confirmed resolution can return a single resource. Source failures do not imply company absence.","security":[{"DeveloperKey":["company:search"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","description":"Company name (2–160 characters)"},"required":false,"description":"Company name (2–160 characters)","name":"query","in":"query"},{"schema":{"type":"string","description":"Required ISO-2 jurisdiction"},"required":false,"description":"Required ISO-2 jurisdiction","name":"country","in":"query"},{"schema":{"type":"string","enum":["compact","full"]},"required":false,"name":"view","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":10,"default":5},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["live","mock","sandbox"],"default":"live"},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"Exact observed resource or source-scoped candidate collection; partial fields and ambiguity remain explicit","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicFullCompanyResourceDelivery"},{"$ref":"#/components/schemas/DisclosurePublicCompactCompanyResourceDelivery"},{"$ref":"#/components/schemas/DisclosurePublicCompanyCollectionDelivery"}]}},"application/ld+json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicCompanyJsonLd"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid parameters"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Scope, organization or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No match in the consulted source scope"},"406":{"$ref":"#/components/responses/PublicError406","description":"A selected exact company is required for JSON-LD"},"422":{"$ref":"#/components/responses/PublicError422","description":"Unsupported jurisdiction/register scope or insufficient exact company profile/identity"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"The durable operation allowance is exhausted"},"503":{"$ref":"#/components/responses/PublicError503","description":"Certified source or runtime unavailable"}}}},"/v1/companies/{jurisdiction}/{id}":{"get":{"operationId":"getCompanyByIdV1","tags":["Company identity"],"summary":"Exact Company Register Lookup","description":"Retrieves a source-observed company by register identity. IDs are never prefixed to fabricate tax/VAT numbers. Specify register when a jurisdiction has multiple certified registers. Missing formal fields remain partial.","security":[{"DeveloperKey":["company:search"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"jurisdiction","in":"path","example":"FR"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path","example":"100000001"},{"schema":{"type":"string","description":"Source-native register identity"},"required":false,"description":"Source-native register identity","name":"register","in":"query"},{"schema":{"type":"string","enum":["compact","full"]},"required":false,"name":"view","in":"query"},{"schema":{"type":"string","enum":["live","mock","sandbox"],"default":"live"},"required":false,"name":"mode","in":"query","example":"sandbox"}],"responses":{"200":{"description":"Exact observed resource or source-scoped candidate collection; partial fields and ambiguity remain explicit","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicFullCompanyResourceDelivery"},{"$ref":"#/components/schemas/DisclosurePublicCompactCompanyResourceDelivery"},{"$ref":"#/components/schemas/DisclosurePublicCompanyCollectionDelivery"}]}},"application/ld+json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicCompanyJsonLd"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid parameters"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Scope, organization or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No match in the consulted source scope"},"406":{"$ref":"#/components/responses/PublicError406","description":"A selected exact company is required for JSON-LD"},"422":{"$ref":"#/components/responses/PublicError422","description":"Unsupported jurisdiction/register scope or insufficient exact company profile/identity"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"The durable operation allowance is exhausted"},"503":{"$ref":"#/components/responses/PublicError503","description":"Certified source or runtime unavailable"}}}},"/v1/vat-numbers/{countryCode}/{vatNumber}":{"get":{"operationId":"getVatNumberV1","tags":["VAT validation"],"summary":"Instant VAT & Entity Check","description":"Cached check of a VAT number with the European Commission VIES service, with a legal entity classification. Validity confirms registration only and does not show that the number belongs to your customer.","security":[{"DeveloperKey":["vat:validate"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","description":"ISO-2 country code"},"required":true,"description":"ISO-2 country code","name":"countryCode","in":"path","example":"DE"},{"schema":{"type":"string","description":"National VAT registration number"},"required":true,"description":"National VAT registration number","name":"vatNumber","in":"path","example":"100"},{"schema":{"type":"string","description":"Output view: compact or full"},"required":false,"description":"Output view: compact or full","name":"view","in":"query"},{"schema":{"type":"string","enum":["live","mock","sandbox"],"default":"live"},"required":false,"name":"mode","in":"query","example":"sandbox"}],"responses":{"200":{"description":"Resolved VAT entity resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicVatResourceDelivery"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request parameters"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Request rate or monthly allowance exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"The source or the durable response snapshot is unavailable"}}}},"/v1/vat-validations":{"post":{"operationId":"createVatValidationV1","tags":["VAT validation"],"summary":"Saved VAT validation","description":"Checks the VAT number with the tax authority and saves the result with its check time and evidence references. Validity confirms registration only and does not show that the number belongs to your customer. The saved record is not a tax treatment decision.","security":[{"DeveloperKey":["vat:validate"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVatValidationInput"},"example":{"countryCode":"DE","vatNumber":"100","mode":"sandbox"}}}},"responses":{"200":{"description":"Saved VAT validation projected into the canonical public envelope","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicVerificationDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request, freshness policy or source capability"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, unfinished or interrupted operation"},"410":{"$ref":"#/components/responses/PublicError410","description":"The saved result expired or was source-suppressed"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Request rate or monthly allowance exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected internal error"},"503":{"$ref":"#/components/responses/PublicError503","description":"No successful save could be confirmed"}}}},"/v1/reference/legal-entities":{"get":{"operationId":"getLegalEntitiesV1","tags":["Capabilities"],"summary":"Legal entity reference availability","description":"This reference family is unavailable until its original production, customer use and notices have an independent current review.","responses":{"503":{"$ref":"#/components/responses/PublicError503","description":"Reference use is not qualified for customer delivery"}}}},"/v1/reference/jurisdictions":{"get":{"operationId":"getJurisdictionsV1","tags":["Capabilities"],"summary":"Jurisdiction reference availability","description":"Reference catalogue delivery requires independent use qualification. Form country choices are not certified authority or capability claims.","responses":{"503":{"$ref":"#/components/responses/PublicError503","description":"Reference use is not qualified for customer delivery"}}}},"/v1/tax/assess":{"post":{"operationId":"assessTaxV1","tags":["Tax and rates"],"summary":"Assess supported service tax treatment from supplied facts","description":"Deterministic, non-billable assessment conditional on supplied facts. No authority request, usage charge or durable provider receipt. Supported ordinary B2B and electronic services require complete supplied facts for a supported territory pair and a tax point from 2026-01-01 through 2027-12-31 inclusive. Rates and amounts are not determined. Supplied source URLs are omitted; only reviewed owning-law citations are disclosed. Requires tax:assess. Environment follows the developer key, or optional mode query for a browser session, defaulting to sandbox.","security":[{"DeveloperKey":["tax:assess"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxAssessmentInputV1"},"example":{"tax_point":"2026-10-01","supply_category":"ordinary_business_service","supplier":{"business_status":"business","evidence_refs":[]},"customer":{"business_status":"business","evidence_refs":[]},"business_use":"business","evidence":[]}}}},"responses":{"200":{"description":"Canonical public assessment, including unassessed outcomes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxAssessmentResultV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid supplied facts or environment query"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"413":{"$ref":"#/components/responses/PublicError413","description":"Request body exceeds 4096 bytes"},"415":{"$ref":"#/components/responses/PublicError415","description":"JSON content type required"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Request admission rate exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Assessment could not be safely delivered"},"503":{"$ref":"#/components/responses/PublicError503","description":"Live admission unavailable"}}}},"/v1/vat/verify":{"post":{"operationId":"verifyVatV1","tags":["VAT validation"],"summary":"Official VAT Validation & Status Verification","description":"Checks supported VAT authority routes and preserves disclosed identity and consultation receipts. Validity confirms registration only and does not show that the number belongs to your customer. GB requires a separately certified HMRC route. Optional company standing requires a known registry identifier mapping and observed administrative status. Neither a receipt nor VAT validity establishes legal admissibility, VAT exemption, solvency or legal dissolution.","security":[{"DeveloperKey":["vat:validate"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VatVerifyInputV1"},"example":{"vat_id":"DE100","mode":"sandbox","view":"full"}}}},"responses":{"200":{"description":"VAT authority outcome and any observed administrative standing, including unavailable or unsupported outcomes. Standing responses preserve independent VAT and company operation receipts.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"description":"Confirmed VAT and standing units delivered by this response; always zero for a replay.","schema":{"type":"string","enum":["0","1","2"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicVatOnlyDelivery"},{"$ref":"#/components/schemas/DisclosurePublicStandingDelivery"}]},"example":{"schemaVersion":"public-delivery-2026-10-13","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","status":"valid","vat_id":"DE100","country_code":"DE","company":{"legal_name":"SYNTHETIC EXAMPLE COMPANY — NOT A REAL BUSINESS","address":{"raw":"100 Sandbox Street — fictional address","formatted":"100 Sandbox Street — Fictional Address, Germany","country":"DE","postal_code":null,"locality":null,"region":null,"street":"100 Sandbox Street — Fictional Address","subdivision_code":null,"iso_subdivision":null,"street_line1":"100 Sandbox Street — Fictional Address","street_line2":null,"components":{"street_category":null,"street_type":null,"street_type_english":null,"street_type_abbreviations":null,"street_name":"100 Sandbox Street — Fictional Address","house_number":null,"house_number_addition":null,"unit":null,"district":null}}},"consultation":{"official_consultation_number":null,"internal_receipt_id":"00000000-0000-4000-8000-000000000001","verified_at":"2026-10-13T12:00:00.000Z","has_official_receipt":false,"is_audit_admissible":false,"source":{"name":null,"url":null,"evidenceRef":"evidence-1","fields":["vat_validity","tax_id","legal_name","address"],"observedAt":"2026-10-13T12:00:00.000Z","retrievedAt":"2026-10-13T12:00:00.000Z","sourceRecordUpdatedAt":null,"datasetPublishedAt":null,"datasetImportedAt":null,"datasetEffectiveAt":null,"category":"synthetic","label":"Synthetic evidence"}},"quota":{"vat_eu_queries":{"cost":1,"allowed":100,"used":1,"remaining":99},"reverse_vat_lookups":{"cost":0,"allowed":20,"used":0,"remaining":20},"company_searches":{"cost":0,"allowed":200,"used":0,"remaining":200},"company_status_verifications":{"cost":0,"allowed":50,"used":0,"remaining":50},"resets_at":"2026-11-01T00:00:00.000Z"},"evidence":[{"id":"evidence-1","source":{"name":null,"url":null,"evidenceRef":"evidence-1","fields":["vat_validity","tax_id","legal_name","address"],"observedAt":"2026-10-13T12:00:00.000Z","retrievedAt":"2026-10-13T12:00:00.000Z","sourceRecordUpdatedAt":null,"datasetPublishedAt":null,"datasetImportedAt":null,"datasetEffectiveAt":null,"category":"synthetic","label":"Synthetic evidence"},"subject":{"taxJurisdiction":"DE","vatPrefix":"DE","vatIdentifier":"100","authorityScope":"vat_registration","kind":"vat_registration"},"environment":"sandbox","attemptedAt":"2026-10-13T12:00:00.000Z","servedAt":"2026-10-13T12:00:01.000Z","completion":"complete","warnings":[]}],"fieldTrust":[{"field":"vat_validity","score":null,"assessment":"unassessed","modelVersion":"field-trust-v1","assessedAt":"2026-10-13T12:00:01.000Z","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","observedPublisherGroups":0,"effectiveCorrelationGroups":0,"provenIndependentLineages":0,"evidenceRefs":[],"reasons":["insufficient_metadata"]},{"field":"tax_id","score":null,"assessment":"unassessed","modelVersion":"field-trust-v1","assessedAt":"2026-10-13T12:00:01.000Z","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","observedPublisherGroups":0,"effectiveCorrelationGroups":0,"provenIndependentLineages":0,"evidenceRefs":[],"reasons":["insufficient_metadata"]},{"field":"legal_name","score":null,"assessment":"unassessed","modelVersion":"field-trust-v1","assessedAt":"2026-10-13T12:00:01.000Z","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","observedPublisherGroups":0,"effectiveCorrelationGroups":0,"provenIndependentLineages":0,"evidenceRefs":[],"reasons":["insufficient_metadata"]},{"field":"address","score":null,"assessment":"unassessed","modelVersion":"field-trust-v1","assessedAt":"2026-10-13T12:00:01.000Z","disclosurePolicyVersion":"government-source-disclosure-v1-2026-10-13","observedPublisherGroups":0,"effectiveCorrelationGroups":0,"provenIndependentLineages":0,"evidenceRefs":[],"reasons":["insufficient_metadata"]}]}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request parameters"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, in-progress or interrupted operation"},"410":{"$ref":"#/components/responses/PublicError410","description":"Saved VAT payload expired or was suppressed under its retention policy"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Monthly quota or rate limit exceeded"},"503":{"$ref":"#/components/responses/PublicError503","description":"Durable operation, saved response or authoritative usage unavailable. REFERENCES_UNCERTAIN means the verification was charged but its references could not be confirmed: retry with the same Idempotency-Key, which replays without a second charge."}}}},"/v1/companies/search":{"post":{"operationId":"searchCompaniesV1","tags":["Company identity"],"summary":"Search Companies through Certified Sources","description":"Searches the certified country catalogue, retrieves an exact register identity, or looks up an LEI; live LEI lookups are delivered only for companies registered in CZ, FI and FR. LEI registration status is separate from company standing and VAT validity. Domain, URL and business-email searches are live only and cite the website as an anonymous company-publication source; in sandbox they return unsupported, and unresolved or competing website identities return scoped errors. Preserves candidate ambiguity, source scope, partial fields and unavailable outcomes. A search started from a tax or VAT identifier checks the registered name with the VAT authority inside the metered company search, charging one company_search unit for every authority answer (valid with a name, valid without a name, or invalid), and zero units when the authority is unavailable or unsupported. A name search returns no VAT identifiers or validity. With lookup_vat, include_vat or validate_vat it is a VAT discovery: one vat_discovery unit, never a company-search unit, returning each candidate's sourced VAT associations and, with validate_vat only, at most one validation of a single candidate's single proposed VAT identifier. An exhausted discovery allowance returns 429 QUOTA_EXCEEDED naming the vat_discovery meter; the request is never downgraded to a plain search. A website-started search never becomes a VAT discovery: with a VAT flag it returns unsupported. A VAT computed from a domestic identifier is a derived candidate (identifier basis derived_rule), never a sourced association, until VIES checks it. Validity confirms registration only and does not show that the number belongs to your customer. A candidate's VAT validity does not confirm that candidate is the company searched for: read each item's identity_state and the resolution's identity_confirmed.","security":[{"DeveloperKey":["company:search"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchInputV1"},"example":{"query":"synthetic atelier exemple","country_code":"FR","mode":"sandbox","limit":5}}}},"responses":{"200":{"description":"Source-scoped candidates, observed identifier associations and explicit resolution outcomes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicCompanyCollectionDelivery"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request parameters"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"The company website is inactive or its retrieved disclosures do not establish a comparable identity"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency key reused with a different company request, or competing website identities require an exact identifier"},"410":{"$ref":"#/components/responses/PublicError410","description":"Saved company payload expired or was suppressed under its retention policy"},"429":{"$ref":"#/components/responses/PublicError429DiscoveryRateLimited","description":"Monthly quota or rate limit exceeded. A VAT-flagged name search whose vat_discovery allowance is exhausted names that meter."},"503":{"$ref":"#/components/responses/PublicError503","description":"The source, operation ledger or authoritative usage is temporarily unavailable"}}}},"/v1/vat/calculate":{"post":{"operationId":"calculateVatV1","tags":["Tax and rates"],"summary":"VAT Rate Card & Itemized Tax Calculation","description":"Computes VAT rates, taxable base, and line-item tax amounts across European jurisdictions. Features automatic multi-signal jurisdiction resolution from explicit country codes, domain TLDs, or client IP headers.","security":[{"DeveloperKey":["vat:validate"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VatCalculateInputV1"},"example":{"country_code":"DE","items":[{"description":"Synthetic software subscription","amount":100,"currency":"EUR"}]}}}},"responses":{"200":{"description":"Resolved VAT rates breakdown and itemized tax calculations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicCalculationDelivery"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request parameters"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment access denied"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency key reused with different calculation input"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Monthly quota or rate limit exceeded"},"503":{"$ref":"#/components/responses/PublicError503","description":"Calculation reference use is unavailable"}}}},"/v1/bulk-jobs/{id}/rows":{"get":{"operationId":"listBulkRows","tags":["Bulk jobs"],"security":[{"DeveloperKey":["bulk:read"]},{"AccountSession":[]}],"summary":"Review saved bulk rows","description":"Read-only saved evidence projection requiring bulk:read. Review status and execution status intersect. Scan at most 500 ordered rows per page; follow nextAfter even when items is empty. Customer VAT and age policies never rewrite authority status or original dates. The DORA profile covers legal-person ICT supplier identifier quality and rejects VAT-only jobs. No source call, operation or additional charge.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path","example":"00000000-0000-4000-8000-000000000003"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"string","enum":["clear","needs_review","pending"]},"required":false,"name":"reviewStatus","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"requireVat","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":36500},"required":false,"name":"maxObservationAgeDays","in":"query"},{"schema":{"type":"string","enum":["general","dora_ict_supplier"],"default":"general"},"required":false,"name":"profile","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":10000},"required":false,"name":"after","in":"query"},{"schema":{"type":"string","enum":["invalid","duplicate","pending","admitted","completed","failed","interrupted","cancelled"]},"required":false,"name":"status","in":"query"}],"responses":{"200":{"description":"Reviewed saved rows; nextAfter advances the bounded scan even without matches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicReviewedBulkRowList"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or malformed CSV"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"Job not found in this organization and environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, action unavailable, or effective active-job plan limit exceeded (BULK_ACTIVE_JOB_LIMIT_EXCEEDED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"Upload, CSV record, or effective plan row limit exceeded (BULK_ROW_LIMIT_EXCEEDED)"},"415":{"$ref":"#/components/responses/PublicError415","description":"Incorrect content type"},"429":{"$ref":"#/components/responses/PublicError429","description":"Request rate exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retryable authority/dependency or import capacity failure"}}}},"/v1/bulk-jobs/{id}/export":{"get":{"operationId":"exportBulkRows","tags":["Bulk jobs"],"security":[{"DeveloperKey":["bulk:read"]},{"AccountSession":[]}],"summary":"Stream rows and evidence as CSV or JSONL, including partial jobs","description":"CSV and JSONL contain separately versioned public rows admitted for current export use. The legacy result_json and source-hint column are empty; public_result_json and record_json contain only projected data. Unknown-use results are withheld with original settlement preserved. Rows stream in order with bounded reads, cancellation and spreadsheet formula escaping. No source requests or new operation charges.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path","example":"00000000-0000-4000-8000-000000000003"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"string","enum":["clear","needs_review","pending"]},"required":false,"name":"reviewStatus","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"requireVat","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":36500},"required":false,"name":"maxObservationAgeDays","in":"query"},{"schema":{"type":"string","enum":["general","dora_ict_supplier"],"default":"general"},"required":false,"name":"profile","in":"query"},{"schema":{"type":"string","enum":["invalid","duplicate","pending","admitted","completed","failed","interrupted","cancelled"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","enum":["csv","jsonl"],"default":"csv"},"required":false,"name":"format","in":"query"}],"responses":{"200":{"description":"Streamed download","content":{"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or malformed CSV"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"Job not found in this organization and environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, action unavailable, or effective active-job plan limit exceeded (BULK_ACTIVE_JOB_LIMIT_EXCEEDED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"Upload, CSV record, or effective plan row limit exceeded (BULK_ROW_LIMIT_EXCEEDED)"},"415":{"$ref":"#/components/responses/PublicError415","description":"Incorrect content type"},"429":{"$ref":"#/components/responses/PublicError429","description":"Request rate exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retryable authority/dependency or import capacity failure"}}}},"/v1/companies/lookup":{"post":{"operationId":"lookupCompanyResourceV2","tags":["Company identity"],"summary":"Open an exact company with retained facts","description":"Performs one idempotent exact lookup through the certified source controller and retains the canonical company resource, including permitted observed facts.","security":[{"DeveloperKey":["company:search"]},{"AccountSession":[]}],"parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Za-z]{2}$"},"register":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"registryId":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9 .-]+$"},"mode":{"type":"string","enum":["sandbox","live"],"default":"sandbox"}},"required":["countryCode","registryId"],"additionalProperties":false},"example":{"countryCode":"FR","register":"vat-tools-sandbox","registryId":"100000001","mode":"sandbox"}}}},"responses":{"200":{"description":"Observed company resource or an identified partial profile with retained facts","headers":{"Idempotency-Key":{"$ref":"#/components/headers/OperationIdempotencyKey"},"X-Operation-Id":{"$ref":"#/components/headers/OperationId"},"Idempotency-Replayed":{"$ref":"#/components/headers/OperationIdempotencyReplayed"},"X-Usage-Charged":{"$ref":"#/components/headers/OperationUsageCharged"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DisclosurePublicFullCompanyResourceDelivery"},{"$ref":"#/components/schemas/DisclosurePublicCompactCompanyResourceDelivery"},{"$ref":"#/components/schemas/DisclosurePublicCompanyCollectionDelivery"}]}},"application/ld+json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicCompanyJsonLd"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid parameters"},"401":{"$ref":"#/components/responses/PublicError401","description":"Missing or invalid authentication"},"403":{"$ref":"#/components/responses/PublicError403","description":"Scope, organization or environment access denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No match in the consulted source scope"},"406":{"$ref":"#/components/responses/PublicError406","description":"A selected exact company is required for JSON-LD"},"409":{"$ref":"#/components/responses/PublicError409","description":"The idempotency key belongs to a different request or an operation is still in progress"},"422":{"$ref":"#/components/responses/PublicError422","description":"Unsupported jurisdiction/register scope or insufficient exact company profile/identity"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"The durable operation allowance is exhausted"},"503":{"$ref":"#/components/responses/PublicError503","description":"Certified source or runtime unavailable"}}}},"/v1/reference/rates":{"get":{"operationId":"getPublicReferenceRates","tags":["Tax and rates"],"summary":"Currently admitted GB rate tiers","description":"GB numeric rate tiers only; not product classification, invoice treatment, currency or a historical rate series. Every delivery is re-admitted and includes its required source and licence notice.","parameters":[{"schema":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 jurisdiction (default GB). Jurisdictions without a current reviewed rate card return 503."},"required":false,"description":"ISO 3166-1 alpha-2 jurisdiction (default GB). Jurisdictions without a current reviewed rate card return 503.","name":"country_code","in":"query"}],"responses":{"200":{"description":"Current permitted rate-tier presentation","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicStaticRateDelivery"},{"$ref":"#/components/schemas/PublicXiStaticRateDelivery"}]}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"503":{"$ref":"#/components/responses/PublicError503","description":"Reference use is not qualified for customer delivery"}}}},"/v1/bulk-jobs":{"post":{"operationId":"importBulkJob","tags":["Bulk jobs"],"security":[{"DeveloperKey":["bulk:write"]},{"AccountSession":[]}],"summary":"Upload a CSV for preview without executing or charging checks","description":"Requires bulk:write and the operation scope of the job kind (vat:validate, company:search, company:verify or vat:discover). Send UTF-8 CSV, at most 10 MiB and 10,000 rows. X-Bulk-Name is an optional percent-encoded UTF-8 name (1–120 decoded characters). Exact file bytes, name, kind and environment form the import identity. A job requires an explicit Start action. Duplicate normalized inputs share the first row's check.","parameters":[{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query","example":"sandbox"},{"schema":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"required":true,"name":"kind","in":"query","example":"vat_validation"},{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"text/csv":{"schema":{"type":"string"},"example":"country_code,vat_number,reference\r\nDE,100,synthetic-vat-example\r\n"}}},"responses":{"200":{"description":"Current persisted job, including on idempotent replay","headers":{"Idempotency-Key":{"description":"Reuse this key after an uncertain response with the same request.","schema":{"type":"string"}},"X-Bulk-Replayed":{"description":"An earlier upload or action was recovered without applying it again.","schema":{"type":"string","enum":["true","false"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicBulkJobDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or malformed CSV"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"Job not found in this organization and environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, action unavailable, or effective active-job plan limit exceeded (BULK_ACTIVE_JOB_LIMIT_EXCEEDED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"Upload, CSV record, or effective plan row limit exceeded (BULK_ROW_LIMIT_EXCEEDED)"},"415":{"$ref":"#/components/responses/PublicError415","description":"Incorrect content type"},"429":{"$ref":"#/components/responses/PublicError429","description":"Request rate exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retryable authority/dependency or import capacity failure"}}},"get":{"operationId":"listBulkJobs","tags":["Bulk jobs"],"security":[{"DeveloperKey":["bulk:read"]},{"AccountSession":[]}],"summary":"List saved bulk jobs","parameters":[{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Newest jobs first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicBulkJobListDelivery"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or malformed CSV"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"Job not found in this organization and environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, action unavailable, or effective active-job plan limit exceeded (BULK_ACTIVE_JOB_LIMIT_EXCEEDED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"Upload, CSV record, or effective plan row limit exceeded (BULK_ROW_LIMIT_EXCEEDED)"},"415":{"$ref":"#/components/responses/PublicError415","description":"Incorrect content type"},"429":{"$ref":"#/components/responses/PublicError429","description":"Request rate exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retryable authority/dependency or import capacity failure"}}}},"/v1/bulk-jobs/{id}":{"get":{"operationId":"getBulkJob","tags":["Bulk jobs"],"security":[{"DeveloperKey":["bulk:read"]},{"AccountSession":[]}],"summary":"Get job progress and pause details","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path","example":"00000000-0000-4000-8000-000000000003"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"Current job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicBulkJobDelivery"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or malformed CSV"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"Job not found in this organization and environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, action unavailable, or effective active-job plan limit exceeded (BULK_ACTIVE_JOB_LIMIT_EXCEEDED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"Upload, CSV record, or effective plan row limit exceeded (BULK_ROW_LIMIT_EXCEEDED)"},"415":{"$ref":"#/components/responses/PublicError415","description":"Incorrect content type"},"429":{"$ref":"#/components/responses/PublicError429","description":"Request rate exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retryable authority/dependency or import capacity failure"}}}},"/v1/bulk-jobs/{id}/start":{"post":{"operationId":"startBulkJob","tags":["Bulk jobs"],"security":[{"DeveloperKey":["bulk:write"]},{"AccountSession":[]}],"summary":"Start a bulk job","description":"Requires bulk:write and the job kind's operation scope. New rows use this actor's current authorization; resuming does not retry interrupted rows under a new key.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path","example":"00000000-0000-4000-8000-000000000003"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Current persisted job, including on idempotent replay","headers":{"Idempotency-Key":{"description":"Reuse this key after an uncertain response with the same request.","schema":{"type":"string"}},"X-Bulk-Replayed":{"description":"An earlier upload or action was recovered without applying it again.","schema":{"type":"string","enum":["true","false"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicBulkJobDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or malformed CSV"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"Job not found in this organization and environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, action unavailable, or effective active-job plan limit exceeded (BULK_ACTIVE_JOB_LIMIT_EXCEEDED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"Upload, CSV record, or effective plan row limit exceeded (BULK_ROW_LIMIT_EXCEEDED)"},"415":{"$ref":"#/components/responses/PublicError415","description":"Incorrect content type"},"429":{"$ref":"#/components/responses/PublicError429","description":"Request rate exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retryable authority/dependency or import capacity failure"}}}},"/v1/bulk-jobs/{id}/resume":{"post":{"operationId":"resumeBulkJob","tags":["Bulk jobs"],"security":[{"DeveloperKey":["bulk:write"]},{"AccountSession":[]}],"summary":"Resume a bulk job","description":"Requires bulk:write and the job kind's operation scope. New rows use this actor's current authorization; resuming does not retry interrupted rows under a new key.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path","example":"00000000-0000-4000-8000-000000000003"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Current persisted job, including on idempotent replay","headers":{"Idempotency-Key":{"description":"Reuse this key after an uncertain response with the same request.","schema":{"type":"string"}},"X-Bulk-Replayed":{"description":"An earlier upload or action was recovered without applying it again.","schema":{"type":"string","enum":["true","false"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicBulkJobDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or malformed CSV"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"Job not found in this organization and environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, action unavailable, or effective active-job plan limit exceeded (BULK_ACTIVE_JOB_LIMIT_EXCEEDED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"Upload, CSV record, or effective plan row limit exceeded (BULK_ROW_LIMIT_EXCEEDED)"},"415":{"$ref":"#/components/responses/PublicError415","description":"Incorrect content type"},"429":{"$ref":"#/components/responses/PublicError429","description":"Request rate exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retryable authority/dependency or import capacity failure"}}}},"/v1/bulk-jobs/{id}/cancel":{"post":{"operationId":"cancelBulkJob","tags":["Bulk jobs"],"security":[{"DeveloperKey":["bulk:write"]},{"AccountSession":[]}],"summary":"Cancel a bulk job","description":"Stops further admission. Already admitted checks may settle. Results remain available.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path","example":"00000000-0000-4000-8000-000000000003"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"},{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Current persisted job, including on idempotent replay","headers":{"Idempotency-Key":{"description":"Reuse this key after an uncertain response with the same request.","schema":{"type":"string"}},"X-Bulk-Replayed":{"description":"An earlier upload or action was recovered without applying it again.","schema":{"type":"string","enum":["true","false"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicBulkJobDelivery"}}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or malformed CSV"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"Job not found in this organization and environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Idempotency conflict, action unavailable, or effective active-job plan limit exceeded (BULK_ACTIVE_JOB_LIMIT_EXCEEDED)"},"413":{"$ref":"#/components/responses/PublicError413","description":"Upload, CSV record, or effective plan row limit exceeded (BULK_ROW_LIMIT_EXCEEDED)"},"415":{"$ref":"#/components/responses/PublicError415","description":"Incorrect content type"},"429":{"$ref":"#/components/responses/PublicError429","description":"Request rate exceeded"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retryable authority/dependency or import capacity failure"}}}},"/v1/bulk-templates/{kind}":{"get":{"operationId":"getBulkTemplate","tags":["Bulk jobs"],"summary":"Download a CSV template for one bulk operation","parameters":[{"schema":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"required":true,"name":"kind","in":"path","example":"vat_validation"}],"responses":{"200":{"description":"CSV sample. Synthetic identifier examples use sandbox; company-name resolution requires a compiled live jurisdiction plan.","content":{"text/csv":{"schema":{"type":"string"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid request or malformed CSV"}}}},"/v1/usage":{"get":{"operationId":"getOrganizationUsage","summary":"Read monthly organization usage and recent operation summaries","description":"Local evaluation allowances are independent for sandbox and live. Pending reservations reduce remaining usage. Summaries omit inputs and results; usage:read does not grant history access.","tags":["Account"],"security":[{"DeveloperKey":["usage:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"Current server period, meters and recent operations","content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"environment":{"type":"string","enum":["sandbox","live"]},"plan":{"type":"object","properties":{"id":{"type":"string","enum":["local-evaluation","trial","inactive","free","starter","growth","scale","business"]},"label":{"type":"string","minLength":1},"commercial":{"type":"boolean"}},"required":["id","label","commercial"]},"policyVersion":{"type":"string","minLength":1},"period":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"string","minLength":7,"maxLength":198,"pattern":"^trial:"}]},"startsAt":{"type":"string","format":"date-time"},"endsAt":{"type":"string","format":"date-time"}},"required":["id","startsAt","endsAt"]},"meters":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_validation","vat_discovery","company_verification","company_search"]},"label":{"type":"string"},"limit":{"type":"integer","minimum":0},"used":{"type":"integer","minimum":0},"reserved":{"type":"integer","minimum":0},"remaining":{"type":"integer","minimum":0}},"required":["kind","label","limit","used","reserved","remaining"]}},"trial":{"type":"object","properties":{"status":{"type":"string","enum":["active","expired","exhausted"]},"startsAt":{"type":"string","format":"date-time"},"endsAt":{"type":"string","format":"date-time"},"policyVersion":{"type":"string","enum":["trial-2026-10-06-v1"]},"periodId":{"type":"string","minLength":7,"maxLength":198},"scope":{"type":"string","enum":["account"]},"pools":{"type":"object","properties":{"vat":{"type":"object","properties":{"used":{"type":"integer","minimum":0},"reserved":{"type":"integer","minimum":0},"remaining":{"type":"integer","minimum":0,"maximum":100},"limit":{"type":"number","enum":[100]},"kinds":{"type":"array","prefixItems":[{"type":"string","enum":["vat_validation"]}]}},"required":["used","reserved","remaining","limit","kinds"],"additionalProperties":false},"company":{"type":"object","properties":{"used":{"type":"integer","minimum":0},"reserved":{"type":"integer","minimum":0},"remaining":{"type":"integer","minimum":0,"maximum":25},"limit":{"type":"number","enum":[25]},"kinds":{"type":"array","prefixItems":[{"type":"string","enum":["company_search"]},{"type":"string","enum":["company_verification"]},{"type":"string","enum":["vat_discovery"]}]}},"required":["used","reserved","remaining","limit","kinds"],"additionalProperties":false}},"required":["vat","company"],"additionalProperties":false}},"required":["status","startsAt","endsAt","policyVersion","periodId","scope","pools"],"additionalProperties":false},"recentOperations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["vat_validation","vat_discovery","company_verification","company_search","account_reconciliation"]},"status":{"type":"string","enum":["reserved","running","completed","failed","interrupted"]},"createdAt":{"type":"string","format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"unitsCharged":{"oneOf":[{"type":"number","enum":[0]},{"type":"number","enum":[1]}]},"settlementReason":{"type":["string","null"],"enum":["completed_lookup","unavailable","unsupported","provider_error","interrupted","late_result","delivery_withheld",null]}},"required":["id","kind","status","createdAt","completedAt","unitsCharged","settlementReason"]},"maxItems":20},"asOf":{"type":"string","format":"date-time"}},"required":["organizationId","environment","plan","policyVersion","period","meters","recentOperations","asOf"]}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid environment"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, scope or environment denied"},"429":{"$ref":"#/components/responses/PublicError429","description":"Request rate exceeded"},"503":{"$ref":"#/components/responses/PublicError503","description":"Usage cannot be confirmed"}}}},"/v1/vat/verify/{receiptId}/certificate.pdf":{"get":{"operationId":"getVatCertificatePdfV1","tags":["Records and history"],"summary":"Download a retained VAT validation record (PDF)","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"description":"Exports admitted facts from the current owned retained VAT original. Performs no source lookup or operation charge. Does not establish legal or audit admissibility.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Original operation ID from the retained VAT validation"},"required":true,"description":"Original operation ID from the retained VAT validation","name":"receiptId","in":"path","example":"00000000-0000-4000-8000-000000000001"},{"schema":{"type":"string","enum":["live","sandbox"]},"required":false,"name":"mode","in":"query"},{"schema":{"type":"string","enum":["en","de","fr"],"description":"Label language: en (default), de or fr. Facts are never translated."},"required":false,"description":"Label language: en (default), de or fr. Facts are never translated.","name":"locale","in":"query"}],"responses":{"200":{"description":"Public retained VAT record","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid retained operation selector"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or history scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No retained VAT operation in this organization environment"},"409":{"$ref":"#/components/responses/PublicError409","description":"Retained export eligibility unavailable"},"410":{"$ref":"#/components/responses/PublicError410","description":"Retained original expired or suppressed"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Incoming request limit reached"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retained original or current export use cannot be confirmed"}}}},"/v1/vat/verify/{receiptId}/record.json":{"get":{"operationId":"getVatRecordJsonV1","tags":["Records and history"],"summary":"Download a retained VAT validation record (JSON)","description":"The admitted facts of the PDF record, with their SHA-256 and the document check link. Performs no source lookup or operation charge. Does not establish legal or audit admissibility.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Original operation ID from the retained VAT validation"},"required":true,"description":"Original operation ID from the retained VAT validation","name":"receiptId","in":"path","example":"00000000-0000-4000-8000-000000000001"},{"schema":{"type":"string","enum":["live","sandbox"]},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"Public retained VAT record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicRecordExport"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid retained operation selector"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or history scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No retained VAT operation in this organization environment"},"410":{"$ref":"#/components/responses/PublicError410","description":"Retained original expired or suppressed"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Incoming request limit reached"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retained original or current export use cannot be confirmed"}}}},"/v1/vat/verify/{receiptId}/record.xml":{"get":{"operationId":"getVatRecordXmlV1","tags":["Records and history"],"summary":"Download a retained VAT validation record (XML)","description":"The admitted facts of the PDF record, with their SHA-256 and the document check link. Performs no source lookup or operation charge. Does not establish legal or audit admissibility. Each XML element mirrors a key of the JSON export.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Original operation ID from the retained VAT validation"},"required":true,"description":"Original operation ID from the retained VAT validation","name":"receiptId","in":"path","example":"00000000-0000-4000-8000-000000000001"},{"schema":{"type":"string","enum":["live","sandbox"]},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"Public retained VAT record","content":{"application/xml":{"schema":{"type":"string"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid retained operation selector"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or history scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No retained VAT operation in this organization environment"},"410":{"$ref":"#/components/responses/PublicError410","description":"Retained original expired or suppressed"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Incoming request limit reached"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retained original or current export use cannot be confirmed"}}}},"/v1/vat/verify/{receiptId}/record.csv":{"get":{"operationId":"getVatRecordCsvV1","tags":["Records and history"],"summary":"Download a retained VAT validation record (CSV)","description":"The admitted facts of the PDF record, with their SHA-256 and the document check link. Performs no source lookup or operation charge. Does not establish legal or audit admissibility. One \"field\",\"value\" row per JSON value, named by its JSON path; null is an empty cell.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Original operation ID from the retained VAT validation"},"required":true,"description":"Original operation ID from the retained VAT validation","name":"receiptId","in":"path","example":"00000000-0000-4000-8000-000000000001"},{"schema":{"type":"string","enum":["live","sandbox"]},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"Public retained VAT record","content":{"text/csv":{"schema":{"type":"string"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid retained operation selector"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or history scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No retained VAT operation in this organization environment"},"410":{"$ref":"#/components/responses/PublicError410","description":"Retained original expired or suppressed"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Incoming request limit reached"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retained original or current export use cannot be confirmed"}}}},"/v1/vat/verify/{receiptId}/consultation":{"get":{"operationId":"getVatRecordConsultationV1","tags":["Records and history"],"summary":"Read the consultation receipt of a retained VAT validation","description":"The authority's consultation number, its observation time and the requester VAT ID you supplied, from the same projection as the record documents. The number is the authority's receipt of this request at the stated time. Issues no document, performs no source lookup or operation charge, and does not establish legal or audit admissibility.","security":[{"DeveloperKey":["history:read"]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Original operation ID from the retained VAT validation"},"required":true,"description":"Original operation ID from the retained VAT validation","name":"receiptId","in":"path","example":"00000000-0000-4000-8000-000000000001"},{"schema":{"type":"string","enum":["live","sandbox"]},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"Consultation receipt of the retained VAT record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicRecordConsultation"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid retained operation selector"},"401":{"$ref":"#/components/responses/PublicError401","description":"Authentication required"},"403":{"$ref":"#/components/responses/PublicError403","description":"Organization, environment or history scope denied"},"404":{"$ref":"#/components/responses/PublicError404","description":"No retained VAT operation in this organization environment"},"410":{"$ref":"#/components/responses/PublicError410","description":"Retained original expired or suppressed"},"429":{"$ref":"#/components/responses/PublicError429RateLimited","description":"Incoming request limit reached"},"503":{"$ref":"#/components/responses/PublicError503","description":"Retained original or current export use cannot be confirmed"}}}},"/v1/coverage":{"get":{"operationId":"getCoverage","tags":["Capabilities"],"summary":"Get the implemented source coverage","responses":{"200":{"description":"VIES coverage; live availability depends on the national authority","content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"},"validation":{"type":"boolean"},"reverseLookup":{"type":"boolean"},"companyVerification":{"type":"boolean"}},"required":["code","label","validation","reverseLookup","companyVerification"]}},"modes":{"type":"array","items":{"type":"string","enum":["sandbox","live"]}},"description":{"type":"string"}},"required":["countries","modes","description"]}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"}}}},"/v1/source-capabilities":{"get":{"operationId":"listSourceCapabilities","tags":["Capabilities"],"summary":"List operation-specific source capabilities and runtime availability","description":"Returns the certified source catalogue, including explicit pipeline and unsupported states. A country is never presented as one blanket capability.","parameters":[{"schema":{"type":"string","enum":["AT","BE","BG","HR","CY","CZ","DK","EE","FI","FR","DE","GR","HU","IE","IT","LV","LT","LU","MT","NL","PL","PT","RO","SK","SI","ES","SE","CH","GB","XI","NO","IS","LI","RS"]},"required":false,"name":"jurisdiction","in":"query"},{"schema":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"required":false,"name":"capability","in":"query"},{"schema":{"type":"string","enum":["sandbox","live"]},"required":false,"name":"environment","in":"query"},{"schema":{"type":"string","enum":["supported","pipeline","unsupported"]},"required":false,"name":"state","in":"query"}],"responses":{"200":{"description":"Source capability records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisclosurePublicSourceCapabilitiesDelivery"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400","description":"Invalid capability filter"},"500":{"$ref":"#/components/responses/PublicError500","description":"Unexpected server failure"}}}},"/v1/webhook-endpoints":{"post":{"operationId":"createWebhookEndpointV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:write"]},{"AccountSession":[]}],"summary":"Create an endpoint","parameters":[{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateEndpointRequestV1"},"example":{"url":"https://hooks.example.com/vat-tools","eventTypes":["verification.completed"],"mode":"sandbox"}}}},"responses":{"200":{"description":"Matching endpoint and signing secret","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateEndpointResponseV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"201":{"description":"Endpoint and signing secret","headers":{"Location":{"description":"Relative endpoint URL","schema":{"type":"string"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateEndpointResponseV1"}}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"409":{"$ref":"#/components/responses/PublicError409"},"413":{"$ref":"#/components/responses/PublicError413"},"415":{"$ref":"#/components/responses/PublicError415"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}},"get":{"operationId":"listWebhookEndpointsV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:read"]},{"AccountSession":[]}],"summary":"List endpoints","parameters":[{"$ref":"#/components/parameters/Webhook1"},{"schema":{"type":"string","maxLength":2048,"format":"uri"},"required":false,"name":"url","in":"query"},{"$ref":"#/components/parameters/Webhook2"},{"$ref":"#/components/parameters/Webhook3"}],"responses":{"200":{"description":"Endpoint page; exact URL filter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointListResponseV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}}},"/v1/webhook-endpoints/{endpointId}":{"get":{"operationId":"getWebhookEndpointV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:read"]},{"AccountSession":[]}],"summary":"Get an endpoint","parameters":[{"$ref":"#/components/parameters/Webhook4"},{"$ref":"#/components/parameters/Webhook1"}],"responses":{"200":{"description":"Endpoint","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"404":{"$ref":"#/components/responses/PublicError404"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}},"patch":{"operationId":"updateWebhookEndpointV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:write"]},{"AccountSession":[]}],"summary":"Update an endpoint","parameters":[{"$ref":"#/components/parameters/Webhook4"},{"$ref":"#/components/parameters/Webhook1"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookUpdateEndpointRequestV1"},"example":{"description":"Sandbox events"}}}},"responses":{"200":{"description":"Updated endpoint","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"404":{"$ref":"#/components/responses/PublicError404"},"409":{"$ref":"#/components/responses/PublicError409"},"413":{"$ref":"#/components/responses/PublicError413"},"415":{"$ref":"#/components/responses/PublicError415"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}},"delete":{"operationId":"deleteWebhookEndpointV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:write"]},{"AccountSession":[]}],"summary":"Delete an endpoint","parameters":[{"$ref":"#/components/parameters/Webhook4"},{"$ref":"#/components/parameters/Webhook1"}],"responses":{"204":{"description":"Deleted; repeated deletion succeeds","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"404":{"$ref":"#/components/responses/PublicError404"},"413":{"$ref":"#/components/responses/PublicError413"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}}},"/v1/webhook-endpoints/{endpointId}/rotate-secret":{"post":{"operationId":"rotateWebhookEndpointSecretV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:write"]},{"AccountSession":[]}],"summary":"Rotate the signing secret","parameters":[{"$ref":"#/components/parameters/Webhook4"},{"$ref":"#/components/parameters/Webhook1"},{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRotateSecretRequestV1"},"example":{"expirePreviousInSeconds":86400}}}},"responses":{"200":{"description":"New secret and previous secret expiry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRotateSecretResponseV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"404":{"$ref":"#/components/responses/PublicError404"},"409":{"$ref":"#/components/responses/PublicError409"},"413":{"$ref":"#/components/responses/PublicError413"},"415":{"$ref":"#/components/responses/PublicError415"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}}},"/v1/webhook-endpoints/{endpointId}/test":{"post":{"operationId":"sendWebhookTestEventV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:write"]},{"AccountSession":[]}],"summary":"Schedule a test event","parameters":[{"$ref":"#/components/parameters/Webhook4"},{"$ref":"#/components/parameters/Webhook1"},{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"202":{"description":"Single-attempt test scheduled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTestEndpointResponseV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"404":{"$ref":"#/components/responses/PublicError404"},"409":{"$ref":"#/components/responses/PublicError409"},"413":{"$ref":"#/components/responses/PublicError413"},"415":{"$ref":"#/components/responses/PublicError415"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}}},"/v1/webhook-endpoints/{endpointId}/deliveries":{"get":{"operationId":"listWebhookDeliveriesV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:read"]},{"AccountSession":[]}],"summary":"List deliveries","parameters":[{"$ref":"#/components/parameters/Webhook4"},{"$ref":"#/components/parameters/Webhook1"},{"schema":{"type":"string","enum":["pending","succeeded","failed","withheld"]},"required":false,"name":"status","in":"query"},{"schema":{"$ref":"#/components/schemas/WebhookEventTypeV1"},"required":false,"name":"eventType","in":"query"},{"$ref":"#/components/parameters/Webhook2"},{"$ref":"#/components/parameters/Webhook3"}],"responses":{"200":{"description":"Delivery page, newest first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryListResponseV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"404":{"$ref":"#/components/responses/PublicError404"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}}},"/v1/webhook-deliveries/{deliveryId}":{"get":{"operationId":"getWebhookDeliveryV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:read"]},{"AccountSession":[]}],"summary":"Get a delivery","parameters":[{"$ref":"#/components/parameters/Webhook5"},{"$ref":"#/components/parameters/Webhook1"}],"responses":{"200":{"description":"Delivery and attempts; unreviewed remote response text is withheld","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryDetailV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"404":{"$ref":"#/components/responses/PublicError404"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}}},"/v1/webhook-endpoints/{endpointId}/recover":{"post":{"operationId":"recoverWebhookDeliveriesV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:write"]},{"AccountSession":[]}],"summary":"Recover failed deliveries","parameters":[{"$ref":"#/components/parameters/Webhook4"},{"$ref":"#/components/parameters/Webhook1"},{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRecoverFailedDeliveriesRequestV1"},"example":{"since":"2026-10-20T00:00:00Z"}}}},"responses":{"202":{"description":"Scheduled count; at most 1000 from the last 30 days","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRecoverFailedDeliveriesResponseV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"404":{"$ref":"#/components/responses/PublicError404"},"409":{"$ref":"#/components/responses/PublicError409"},"413":{"$ref":"#/components/responses/PublicError413"},"415":{"$ref":"#/components/responses/PublicError415"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}}},"/v1/webhook-deliveries/{deliveryId}/redeliver":{"post":{"operationId":"redeliverWebhookDeliveryV1","tags":["Webhooks"],"security":[{"DeveloperKey":["webhooks:write"]},{"AccountSession":[]}],"summary":"Redeliver an event","parameters":[{"$ref":"#/components/parameters/Webhook5"},{"$ref":"#/components/parameters/Webhook1"},{"$ref":"#/components/parameters/OperationIdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"202":{"description":"Redelivery retaining the event identity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRedeliverResponseV1"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"$ref":"#/components/responses/PublicError400"},"401":{"$ref":"#/components/responses/PublicError401"},"403":{"$ref":"#/components/responses/PublicError403"},"404":{"$ref":"#/components/responses/PublicError404"},"409":{"$ref":"#/components/responses/PublicError409"},"413":{"$ref":"#/components/responses/PublicError413"},"415":{"$ref":"#/components/responses/PublicError415"},"429":{"$ref":"#/components/responses/PublicError429"},"500":{"$ref":"#/components/responses/PublicError500"},"503":{"$ref":"#/components/responses/PublicError503"}}}}},"webhooks":{"monitor.cannot_see":{"post":{"summary":"Receive monitor.cannot_see","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventEnvelopeMonitorCannotSeeV1"}}}},"responses":{"200":{"description":"Event accepted"}}}},"verification.completed":{"post":{"summary":"Receive verification.completed","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventEnvelopeVerificationCompletedV1"}}}},"responses":{"200":{"description":"Event accepted"}}}},"bulk_job.completed":{"post":{"summary":"Receive bulk_job.completed","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventEnvelopeBulkJobCompletedV1"}}}},"responses":{"200":{"description":"Event accepted"}}}},"monitor.change_observed":{"post":{"summary":"Receive monitor.change_observed","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventEnvelopeMonitorChangeObservedV1"}}}},"responses":{"200":{"description":"Event accepted"}}}},"monitor.visibility_restored":{"post":{"summary":"Receive monitor.visibility_restored","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventEnvelopeMonitorVisibilityRestoredV1"}}}},"responses":{"200":{"description":"Event accepted"}}}},"webhook.test":{"post":{"summary":"Receive webhook.test","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventEnvelopeWebhookTestV1"}}}},"responses":{"200":{"description":"Event accepted"}}}}}}