{"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 and `retryAfterSeconds` in the error body. 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/v1","description":"Production API"},{"url":"http://127.0.0.1:4001/v1","description":"Local development server"}],"components":{"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":"Verified browser session. Product requests require X-Organization-Id; mutations require the trusted Origin."}},"schemas":{"NormalizedAddressV1":{"type":"object","properties":{"raw":{"type":["string","null"],"description":"Verbatim, unparsed address string returned by the official tax authority or registry.","example":"VIA MARGHERA 2 \n00185 ROMA RM"},"formatted":{"type":["string","null"],"description":"Normalized single-line address formatted according to national postal conventions.","example":"Via Marghera 2, 00185 Roma RM, Italy"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 two-letter country code.","example":"IT"},"postal_code":{"type":["string","null"],"description":"National postal code / ZIP code as string (preserves leading zeroes).","example":"00185"},"locality":{"type":["string","null"],"description":"City, municipality, town, or post town.","example":"Roma"},"region":{"type":["string","null"],"description":"Top-level administrative region, autonomous community, federal state, or province name.","example":"Lazio"},"subdivision_code":{"type":["string","null"],"description":"Short national subdivision code (e.g. Italian province 'RM', Spanish province 'M', US state 'CA').","example":"RM"},"iso_subdivision":{"type":["string","null"],"pattern":"^[A-Z]{2}-[A-Z0-9]{1,4}$","description":"Standardized ISO 3166-2 principal subdivision code (e.g. 'IT-RM', 'ES-M', 'DE-BY', 'US-CA').","example":"IT-RM"},"street":{"type":["string","null"],"description":"Combined thoroughfare name and type (e.g. 'Via Marghera', 'Calle Alcalá', 'Oxford Street').","example":"Via Marghera"},"street_line1":{"type":["string","null"],"description":"Stripe-compatible primary address line (thoroughfare and house number).","example":"Via Marghera 2"},"street_line2":{"type":["string","null"],"description":"Stripe-compatible secondary address line (suite, unit, floor, door, or building).","example":null},"components":{"$ref":"#/components/schemas/AddressComponentsV1"},"metadata":{"$ref":"#/components/schemas/AddressMetadataV1"}},"required":["raw","formatted","country","postal_code","locality","region","subdivision_code","iso_subdivision","street","street_line1","street_line2"],"additionalProperties":false},"AddressComponentsV1":{"type":["object","null"],"properties":{"street_category":{"type":["string","null"],"enum":["street","avenue","boulevard","square","road","lane","way","walk","drive","alley","court","place","quay","crescent","roundabout","passage","industrial_zone","path","other",null],"description":"Canonical thoroughfare classification constant in English (e.g. 'street', 'avenue', 'square', 'road').","example":"street"},"street_type":{"type":["string","null"],"description":"Localized thoroughfare word in the jurisdiction's official language (e.g. 'Calle', 'Via', 'Rue', 'Straße', 'Ulica', 'Gata').","example":"Calle"},"street_type_english":{"type":["string","null"],"description":"English translation / generic meaning of the localized street type (e.g. 'Street', 'Avenue', 'Square').","example":"Street"},"street_type_abbreviations":{"type":["array","null"],"items":{"type":"string"},"description":"Known official abbreviations, acronyms, and preposition/article variants for the street type in this country.","example":["C/","C.","C","C de","C/ de"]},"street_name":{"type":["string","null"],"description":"Primary thoroughfare name excluding type prefix and house number.","example":"Marghera"},"house_number":{"type":["string","null"],"description":"Primary building or house number.","example":"2"},"house_number_addition":{"type":["string","null"],"description":"House number suffix, letter, or modifier (e.g. 'B', 'bis', 'ter', 'Apt 2').","example":null},"unit":{"type":["string","null"],"description":"Secondary unit, staircase, floor, door, or suite identifier.","example":"int. 4"},"district":{"type":["string","null"],"description":"Sub-locality, neighborhood, borough, or dependent locality.","example":"Esquilino"}},"additionalProperties":false},"AddressMetadataV1":{"type":["object","null"],"properties":{"confidence":{"type":"string","enum":["high","medium","low"],"description":"Confidence level of address decomposition and normalization.","example":"high"},"parser":{"type":"string","enum":["deterministic","llm","authority_provided"],"description":"Engine responsible for the normalized structure.","example":"deterministic"},"normalized_at":{"type":"string","description":"ISO 8601 timestamp when normalization was performed.","example":"2026-09-28T14:30:00.000Z"}},"required":["confidence","parser","normalized_at"],"additionalProperties":false},"PublicVatValidationEnvelope":{"type":"object","properties":{"schemaVersion":{"$ref":"#/components/schemas/PublicVerificationSchemaVersion"},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["vat_validation"]},"status":{"type":"string","enum":["completed"]},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"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},"subject":{"$ref":"#/components/schemas/VatValidationOperationSubject"},"result":{"$ref":"#/components/schemas/VatValidationResult"},"claims":{"type":"array","items":{"$ref":"#/components/schemas/VerificationClaim"},"maxItems":500},"relationships":{"type":"array","items":{"$ref":"#/components/schemas/VerificationRelationship"},"maxItems":500},"conflicts":{"type":"array","items":{"$ref":"#/components/schemas/VerificationConflict"},"maxItems":100},"issues":{"type":"array","items":{"$ref":"#/components/schemas/VerificationIssue"},"maxItems":100},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/VerificationEvidence"},"maxItems":500},"staleEvidence":{"type":"array","items":{"$ref":"#/components/schemas/VerificationEvidence"},"maxItems":500},"freshness":{"$ref":"#/components/schemas/VerificationFreshness"},"usage":{"$ref":"#/components/schemas/VerificationUsageSettlement"}},"required":["schemaVersion","operation","subject","result","claims","relationships","conflicts","issues","evidence","staleEvidence","freshness","usage"],"additionalProperties":false},"PublicVerificationSchemaVersion":{"type":"string","enum":["2026-09-01"]},"VerificationEnvironment":{"type":"string","enum":["sandbox","live"]},"VatValidationOperationSubject":{"type":"object","properties":{"vatRegistration":{"$ref":"#/components/schemas/VatRegistrationIdentity"},"customerAccount":{"$ref":"#/components/schemas/CustomerAccountIdentity"}},"required":["vatRegistration"],"additionalProperties":false},"VatRegistrationIdentity":{"type":"object","properties":{"taxJurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"vatPrefix":{"type":"string","pattern":"^[A-Z]{2}$"},"vatIdentifier":{"type":"string","minLength":3,"maxLength":64},"authorityScope":{"type":"string","minLength":1,"maxLength":160}},"required":["taxJurisdiction","vatPrefix","vatIdentifier","authorityScope"],"additionalProperties":false},"CustomerAccountIdentity":{"type":"object","properties":{"reference":{"type":"string","minLength":1,"maxLength":160}},"required":["reference"],"additionalProperties":false},"VatValidationResult":{"oneOf":[{"$ref":"#/components/schemas/ValidVatValidationResult"},{"$ref":"#/components/schemas/InvalidVatValidationResult"},{"$ref":"#/components/schemas/UnsupportedVatValidationResult"},{"$ref":"#/components/schemas/UnavailableVatValidationResult"}],"discriminator":{"propertyName":"outcome","mapping":{"valid":"#/components/schemas/ValidVatValidationResult","invalid":"#/components/schemas/InvalidVatValidationResult","unsupported":"#/components/schemas/UnsupportedVatValidationResult","source_unavailable":"#/components/schemas/UnavailableVatValidationResult"}}},"ValidVatValidationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_validation"]},"vatRegistration":{"$ref":"#/components/schemas/VatRegistrationIdentity"},"legalName":{"type":["string","null"],"maxLength":500},"address":{"type":["string","null"],"maxLength":1000},"legalEntity":{"$ref":"#/components/schemas/ReconciledLegalEntityV2"},"outcome":{"type":"string","enum":["valid"]},"checkedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","vatRegistration","legalName","address","outcome","checkedAt","cached","evidenceRefs"],"additionalProperties":false},"ReconciledLegalEntityV2":{"type":["object","null"],"properties":{"rawSuffix":{"type":["string","null"]},"canonicalAcronym":{"type":["string","null"]},"nativeName":{"type":["string","null"]},"englishName":{"type":["string","null"]},"category":{"$ref":"#/components/schemas/LegalEntityCategoryCode"},"isoElfCode":{"type":["string","null"]},"confidence":{"$ref":"#/components/schemas/ReconciledLegalEntityConfidence"},"categoryContext":{"type":["object","null"],"properties":{"formalDescription":{"type":"string"},"commonAnalogue":{"type":"string"}},"required":["formalDescription","commonAnalogue"]}},"required":["rawSuffix","canonicalAcronym","nativeName","englishName","category","isoElfCode","confidence","categoryContext"],"additionalProperties":false},"LegalEntityCategoryCode":{"type":["string","null"],"enum":["private_limited","public_limited","general_partnership","limited_partnership","sole_proprietorship","cooperative_mutual","association_ngo","foundation_endowment","trust_fiduciary","supranational_eu","foreign_branch",null]},"ReconciledLegalEntityConfidence":{"type":"string","enum":["explicit","extracted_from_context","registry_corroborated","inferred","none"]},"InvalidVatValidationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_validation"]},"vatRegistration":{"$ref":"#/components/schemas/VatRegistrationIdentity"},"legalName":{"type":["string","null"],"maxLength":500},"address":{"type":["string","null"],"maxLength":1000},"legalEntity":{"$ref":"#/components/schemas/ReconciledLegalEntityV2"},"outcome":{"type":"string","enum":["invalid"]},"checkedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","vatRegistration","legalName","address","outcome","checkedAt","cached","evidenceRefs"],"additionalProperties":false},"UnsupportedVatValidationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_validation"]},"vatRegistration":{"$ref":"#/components/schemas/VatRegistrationIdentity"},"legalName":{"type":"null"},"address":{"type":"null"},"legalEntity":{"$ref":"#/components/schemas/ReconciledLegalEntityV2"},"outcome":{"type":"string","enum":["unsupported"]},"checkedAt":{"type":"null"},"cached":{"type":"boolean","enum":[false]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":0}},"required":["kind","vatRegistration","legalName","address","outcome","checkedAt","cached","evidenceRefs"],"additionalProperties":false},"UnavailableVatValidationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_validation"]},"vatRegistration":{"$ref":"#/components/schemas/VatRegistrationIdentity"},"legalName":{"type":"null"},"address":{"type":"null"},"legalEntity":{"$ref":"#/components/schemas/ReconciledLegalEntityV2"},"outcome":{"type":"string","enum":["source_unavailable"]},"checkedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean","enum":[false]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","vatRegistration","legalName","address","outcome","checkedAt","cached","evidenceRefs"],"additionalProperties":false},"VerificationClaim":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"type":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*$"},"outcome":{"type":"string","enum":["confirmed","not_confirmed","ambiguous","conflicting","not_disclosed","not_found","unknown","unsupported","source_unavailable"]},"expectedValue":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"value":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"rawValue":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"meaning":{"type":["string","null"],"minLength":1,"maxLength":2000},"scope":{"type":"object","properties":{"jurisdiction":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"register":{"type":["string","null"],"minLength":1,"maxLength":160},"authorityScope":{"type":["string","null"],"minLength":1,"maxLength":240}},"required":["jurisdiction","register","authorityScope"],"additionalProperties":false},"method":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*$"},"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"}]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["id","type","outcome","expectedValue","value","rawValue","meaning","scope","method","effectiveFrom","effectiveTo","evidenceRefs"],"additionalProperties":false},"VerificationRelationship":{"oneOf":[{"$ref":"#/components/schemas/EstablishmentOfRelationship"},{"$ref":"#/components/schemas/BranchOfRelationship"},{"$ref":"#/components/schemas/ForeignRegistrationOfRelationship"},{"$ref":"#/components/schemas/VatRegistrationOfRelationship"},{"$ref":"#/components/schemas/MemberOfVatGroupRelationship"},{"$ref":"#/components/schemas/PreviousIdentityOfRelationship"},{"$ref":"#/components/schemas/SuccessorOfRelationship"}],"discriminator":{"propertyName":"type","mapping":{"establishment_of":"#/components/schemas/EstablishmentOfRelationship","branch_of":"#/components/schemas/BranchOfRelationship","foreign_registration_of":"#/components/schemas/ForeignRegistrationOfRelationship","vat_registration_of":"#/components/schemas/VatRegistrationOfRelationship","member_of_vat_group":"#/components/schemas/MemberOfVatGroupRelationship","previous_identity_of":"#/components/schemas/PreviousIdentityOfRelationship","successor_of":"#/components/schemas/SuccessorOfRelationship"}}},"EstablishmentOfRelationship":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"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"}]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"type":{"type":"string","enum":["establishment_of"]},"from":{"$ref":"#/components/schemas/EstablishmentReference"},"to":{"$ref":"#/components/schemas/LegalEntityReference"}},"required":["id","outcome","effectiveFrom","effectiveTo","evidenceRefs","type","from","to"],"additionalProperties":false},"EstablishmentReference":{"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},"kind":{"type":"string","enum":["establishment"]}},"required":["jurisdiction","register","registryId","kind"],"additionalProperties":false},"LegalEntityReference":{"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},"kind":{"type":"string","enum":["legal_entity"]}},"required":["jurisdiction","register","registryId","kind"],"additionalProperties":false},"BranchOfRelationship":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"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"}]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"type":{"type":"string","enum":["branch_of"]},"from":{"$ref":"#/components/schemas/EstablishmentReference"},"to":{"$ref":"#/components/schemas/LegalEntityReference"}},"required":["id","outcome","effectiveFrom","effectiveTo","evidenceRefs","type","from","to"],"additionalProperties":false},"ForeignRegistrationOfRelationship":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"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"}]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"type":{"type":"string","enum":["foreign_registration_of"]},"from":{"$ref":"#/components/schemas/ForeignRegistrationReference"},"to":{"$ref":"#/components/schemas/LegalEntityReference"}},"required":["id","outcome","effectiveFrom","effectiveTo","evidenceRefs","type","from","to"],"additionalProperties":false},"ForeignRegistrationReference":{"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},"kind":{"type":"string","enum":["foreign_registration"]}},"required":["jurisdiction","register","registryId","kind"],"additionalProperties":false},"VatRegistrationOfRelationship":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"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"}]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"type":{"type":"string","enum":["vat_registration_of"]},"from":{"$ref":"#/components/schemas/VatRegistrationReference"},"to":{"$ref":"#/components/schemas/LegalEntityReference"}},"required":["id","outcome","effectiveFrom","effectiveTo","evidenceRefs","type","from","to"],"additionalProperties":false},"VatRegistrationReference":{"type":"object","properties":{"taxJurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"vatPrefix":{"type":"string","pattern":"^[A-Z]{2}$"},"vatIdentifier":{"type":"string","minLength":3,"maxLength":64},"authorityScope":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","enum":["vat_registration"]}},"required":["taxJurisdiction","vatPrefix","vatIdentifier","authorityScope","kind"],"additionalProperties":false},"MemberOfVatGroupRelationship":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"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"}]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"type":{"type":"string","enum":["member_of_vat_group"]},"from":{"$ref":"#/components/schemas/LegalEntityReference"},"to":{"$ref":"#/components/schemas/VatRegistrationReference"}},"required":["id","outcome","effectiveFrom","effectiveTo","evidenceRefs","type","from","to"],"additionalProperties":false},"PreviousIdentityOfRelationship":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"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"}]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"type":{"type":"string","enum":["previous_identity_of"]},"from":{"$ref":"#/components/schemas/LegalEntityReference"},"to":{"$ref":"#/components/schemas/LegalEntityReference"}},"required":["id","outcome","effectiveFrom","effectiveTo","evidenceRefs","type","from","to"],"additionalProperties":false},"SuccessorOfRelationship":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"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"}]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"type":{"type":"string","enum":["successor_of"]},"from":{"$ref":"#/components/schemas/LegalEntityReference"},"to":{"$ref":"#/components/schemas/LegalEntityReference"}},"required":["id","outcome","effectiveFrom","effectiveTo","evidenceRefs","type","from","to"],"additionalProperties":false},"VerificationConflict":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"claimRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"relationshipRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":2,"maxItems":100},"authorityPolicyVersion":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"resolution":{"type":"string","enum":["unresolved","authority_policy","operator_selected","customer_policy"]},"selectedEvidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"explanation":{"type":"string","minLength":1,"maxLength":2000}},"required":["id","claimRefs","relationshipRefs","evidenceRefs","authorityPolicyVersion","resolution","selectedEvidenceRefs","explanation"],"additionalProperties":false},"VerificationIssue":{"oneOf":[{"$ref":"#/components/schemas/ResultVerificationIssue"},{"$ref":"#/components/schemas/EmbeddedVatValidationIssue"},{"$ref":"#/components/schemas/EvidenceVerificationIssue"}],"discriminator":{"propertyName":"target","mapping":{"result":"#/components/schemas/ResultVerificationIssue","embedded_vat_validation":"#/components/schemas/EmbeddedVatValidationIssue","evidence":"#/components/schemas/EvidenceVerificationIssue"}}},"ResultVerificationIssue":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"target":{"type":"string","enum":["result"]},"code":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"message":{"type":"string","minLength":1,"maxLength":2000},"retryable":{"type":"boolean"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100,"uniqueItems":true}},"required":["id","target","code","message","retryable","evidenceRefs"],"additionalProperties":false},"EmbeddedVatValidationIssue":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"target":{"type":"string","enum":["embedded_vat_validation"]},"code":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"message":{"type":"string","minLength":1,"maxLength":2000},"retryable":{"type":"boolean"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100,"uniqueItems":true}},"required":["id","target","code","message","retryable","evidenceRefs"],"additionalProperties":false},"EvidenceVerificationIssue":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"target":{"type":"string","enum":["evidence"]},"code":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"message":{"type":"string","minLength":1,"maxLength":2000},"retryable":{"type":"boolean"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100,"uniqueItems":true}},"required":["id","target","code","message","retryable","evidenceRefs"],"additionalProperties":false},"VerificationEvidence":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"source":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"name":{"type":"string","minLength":1,"maxLength":240},"classification":{"type":["string","null"],"enum":["official_register","official_tax_authority","official_dataset","licensed_provider","private_index","company_website","sandbox_fixture",null]},"url":{"type":"string","format":"uri"}},"required":["id","name","classification","url"],"additionalProperties":false},"sourceRecordId":{"type":["string","null"],"minLength":1,"maxLength":240},"subject":{"$ref":"#/components/schemas/NullableVerificationSubjectReference"},"capability":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"authorityScope":{"type":["string","null"],"minLength":1,"maxLength":240},"attemptedAt":{"type":["string","null"],"format":"date-time"},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"servedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetPublishedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetImportedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetEffectiveAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"deliveryForm":{"type":"string","enum":["live_source_call","official_snapshot","cached_observation","coalesced_observation","sandbox_fixture"]},"rightsReference":{"type":["string","null"],"format":"uri"},"rightsPolicyVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"parserVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"coveragePolicyVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"nativeStatus":{"type":["string","null"],"maxLength":500},"nativeValue":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"completion":{"$ref":"#/components/schemas/EvidenceCompletion"},"warnings":{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"maxItems":64},"suppression":{"type":"object","properties":{"suppressed":{"type":"boolean"},"reason":{"type":["string","null"],"minLength":1,"maxLength":500},"effectiveAt":{"type":["string","null"],"format":"date-time"}},"required":["suppressed","reason","effectiveAt"],"additionalProperties":false},"contentDigest":{"type":["string","null"],"pattern":"^sha256:[a-f0-9]{64}$"},"proofReference":{"type":["string","null"],"minLength":1,"maxLength":500},"metadataCompleteness":{"type":"string","enum":["complete","legacy_partial"]}},"required":["id","source","sourceRecordId","subject","capability","environment","authorityScope","attemptedAt","observedAt","retrievedAt","servedAt","sourceRecordUpdatedAt","datasetPublishedAt","datasetImportedAt","datasetEffectiveAt","deliveryForm","rightsReference","rightsPolicyVersion","parserVersion","coveragePolicyVersion","nativeStatus","nativeValue","completion","warnings","suppression","contentDigest","proofReference","metadataCompleteness"],"additionalProperties":false},"NullableVerificationSubjectReference":{"oneOf":[{"$ref":"#/components/schemas/LegalEntityReference"},{"$ref":"#/components/schemas/EstablishmentReference"},{"$ref":"#/components/schemas/VatRegistrationReference"},{"$ref":"#/components/schemas/ForeignRegistrationReference"},{"$ref":"#/components/schemas/CustomerAccountReference"},{"type":"null"}]},"CustomerAccountReference":{"type":"object","properties":{"reference":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","enum":["customer_account"]}},"required":["reference","kind"],"additionalProperties":false},"NullableSourceTemporalValue":{"oneOf":[{"$ref":"#/components/schemas/SourceTemporalValue"},{"type":"null"}]},"SourceTemporalValue":{"type":"object","properties":{"raw":{"type":"string","minLength":1,"maxLength":160},"normalized":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"timezone":{"type":["string","null"],"minLength":1,"maxLength":80}},"required":["raw","normalized","timezone"],"additionalProperties":false},"EvidenceCompletion":{"oneOf":[{"$ref":"#/components/schemas/CompleteEvidenceBoundary"},{"$ref":"#/components/schemas/IncompleteEvidenceBoundary"}],"discriminator":{"propertyName":"state","mapping":{"complete":"#/components/schemas/CompleteEvidenceBoundary","incomplete":"#/components/schemas/IncompleteEvidenceBoundary"}}},"CompleteEvidenceBoundary":{"type":"object","properties":{"state":{"type":"string","enum":["complete"]},"pagination":{"type":"string","enum":["complete","not_applicable"]},"recordsReturned":{"type":["integer","null"],"minimum":0},"totalRecords":{"type":["integer","null"],"minimum":0}},"required":["state","pagination","recordsReturned","totalRecords"],"additionalProperties":false},"IncompleteEvidenceBoundary":{"type":"object","properties":{"state":{"type":"string","enum":["incomplete"]},"pagination":{"type":"string","enum":["truncated","unknown"]},"reason":{"type":"string","enum":["source_unavailable","timeout","truncated","schema_drift","provider_error","unknown"]},"recordsReturned":{"type":["integer","null"],"minimum":0},"totalRecords":{"type":["integer","null"],"minimum":0}},"required":["state","pagination","reason","recordsReturned","totalRecords"],"additionalProperties":false},"VerificationFreshness":{"type":"object","properties":{"requestedMaxAgeSeconds":{"type":["integer","null"],"minimum":0},"defaultMaxAgeSeconds":{"type":"integer","minimum":0},"effectiveMaxAgeSeconds":{"type":"integer","minimum":0},"allowStale":{"type":"boolean"},"satisfied":{"type":"boolean"},"sourceCadenceSeconds":{"type":["integer","null"],"exclusiveMinimum":0},"limitation":{"type":["string","null"],"minLength":1,"maxLength":500}},"required":["requestedMaxAgeSeconds","defaultMaxAgeSeconds","effectiveMaxAgeSeconds","allowStale","satisfied","sourceCadenceSeconds","limitation"],"additionalProperties":false},"VerificationUsageSettlement":{"oneOf":[{"$ref":"#/components/schemas/ChargedVerificationUsageSettlement"},{"$ref":"#/components/schemas/UnchargedVerificationUsageSettlement"}],"discriminator":{"propertyName":"settlementReason","mapping":{"completed":"#/components/schemas/ChargedVerificationUsageSettlement","unsupported":"#/components/schemas/UnchargedVerificationUsageSettlement","source_unavailable":"#/components/schemas/UnchargedVerificationUsageSettlement","incomplete":"#/components/schemas/UnchargedVerificationUsageSettlement","failed":"#/components/schemas/UnchargedVerificationUsageSettlement","interrupted":"#/components/schemas/UnchargedVerificationUsageSettlement","replayed":"#/components/schemas/UnchargedVerificationUsageSettlement","duplicate":"#/components/schemas/UnchargedVerificationUsageSettlement","cancelled":"#/components/schemas/UnchargedVerificationUsageSettlement","late_result":"#/components/schemas/UnchargedVerificationUsageSettlement"}}},"ChargedVerificationUsageSettlement":{"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},"UnchargedVerificationUsageSettlement":{"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},"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},"PublicCompanySearchEnvelope":{"type":"object","properties":{"schemaVersion":{"$ref":"#/components/schemas/PublicVerificationSchemaVersion"},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["company_search"]},"status":{"type":"string","enum":["completed"]},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"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},"subject":{"$ref":"#/components/schemas/CompanySearchOperationSubject"},"result":{"$ref":"#/components/schemas/CompanySearchResult"},"claims":{"type":"array","items":{"$ref":"#/components/schemas/VerificationClaim"},"maxItems":500},"relationships":{"type":"array","items":{"$ref":"#/components/schemas/VerificationRelationship"},"maxItems":500},"conflicts":{"type":"array","items":{"$ref":"#/components/schemas/VerificationConflict"},"maxItems":100},"issues":{"type":"array","items":{"$ref":"#/components/schemas/VerificationIssue"},"maxItems":100},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/VerificationEvidence"},"maxItems":500},"staleEvidence":{"type":"array","items":{"$ref":"#/components/schemas/VerificationEvidence"},"maxItems":500},"freshness":{"$ref":"#/components/schemas/VerificationFreshness"},"usage":{"$ref":"#/components/schemas/VerificationUsageSettlement"}},"required":["schemaVersion","operation","subject","result","claims","relationships","conflicts","issues","evidence","staleEvidence","freshness","usage"],"additionalProperties":false},"CompanySearchOperationSubject":{"type":"object","properties":{"search":{"$ref":"#/components/schemas/CompanySearchSubject"},"customerAccount":{"$ref":"#/components/schemas/CustomerAccountIdentity"}},"required":["search"],"additionalProperties":false},"CompanySearchSubject":{"type":"object","properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160}},"required":["jurisdiction","query"],"additionalProperties":false},"CompanySearchResult":{"oneOf":[{"$ref":"#/components/schemas/FoundCompanySearchResult"},{"$ref":"#/components/schemas/NotFoundCompanySearchResult"},{"$ref":"#/components/schemas/AmbiguousCompanySearchResult"},{"$ref":"#/components/schemas/PartialCompanySearchResult"},{"$ref":"#/components/schemas/ConflictingCompanySearchResult"},{"$ref":"#/components/schemas/UnsupportedCompanySearchResult"},{"$ref":"#/components/schemas/UnavailableCompanySearchResult"}],"discriminator":{"propertyName":"outcome","mapping":{"found":"#/components/schemas/FoundCompanySearchResult","not_found":"#/components/schemas/NotFoundCompanySearchResult","ambiguous":"#/components/schemas/AmbiguousCompanySearchResult","partial":"#/components/schemas/PartialCompanySearchResult","conflicting":"#/components/schemas/ConflictingCompanySearchResult","unsupported":"#/components/schemas/UnsupportedCompanySearchResult","source_unavailable":"#/components/schemas/UnavailableCompanySearchResult"}}},"FoundCompanySearchResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_search"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CompanyCandidate"},"minItems":1,"maxItems":100},"totalResults":{"type":["integer","null"],"exclusiveMinimum":0},"truncated":{"type":"boolean","enum":[false]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"outcome":{"type":"string","enum":["found"]},"resolution":{"$ref":"#/components/schemas/ResolvedCandidateResolution"}},"required":["kind","jurisdiction","query","candidates","totalResults","truncated","evidenceRefs","outcome","resolution"],"additionalProperties":false},"CompanyCandidate":{"type":"object","properties":{"rank":{"type":"integer","exclusiveMinimum":0,"maximum":100},"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"legalName":{"type":["string","null"],"maxLength":500},"registeredAddress":{"type":"object","properties":{"fullAddress":{"type":["string","null"],"maxLength":1000},"postalCode":{"type":["string","null"],"maxLength":80},"locality":{"type":["string","null"],"maxLength":240},"countryCode":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"countryLabel":{"type":["string","null"],"maxLength":240}},"required":["fullAddress","postalCode","locality","countryCode","countryLabel"],"additionalProperties":false},"rawStatus":{"type":["string","null"],"maxLength":500},"sourceFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","maxLength":80,"pattern":"^[a-z][A-Za-z0-9]*$"},"value":{"type":["string","null"],"maxLength":1000},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["field","value","evidenceRefs"],"additionalProperties":false},"minItems":1,"maxItems":100},"matchReasons":{"type":"array","items":{"$ref":"#/components/schemas/CandidateMatchReason"},"minItems":1,"maxItems":100}},"required":["rank","entity","legalName","registeredAddress","rawStatus","sourceFields","matchReasons"],"additionalProperties":false},"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},"CandidateMatchReason":{"type":"object","properties":{"field":{"type":"string","maxLength":80,"pattern":"^[a-z][A-Za-z0-9]*$"},"method":{"type":"string","enum":["authoritative_identifier","exact","normalized","prefix","token_overlap","address","source_rank","sourced_association"]},"effect":{"type":"string","enum":["supports","contradicts","neutral"]},"queryValue":{"type":["string","null"],"maxLength":1000},"candidateValue":{"type":["string","null"],"maxLength":1000},"description":{"type":"string","minLength":1,"maxLength":500},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["field","method","effect","queryValue","candidateValue","description","evidenceRefs"],"additionalProperties":false},"ResolvedCandidateResolution":{"oneOf":[{"$ref":"#/components/schemas/AuthoritativeIdentifierResolution"},{"$ref":"#/components/schemas/UniqueSourcedAssociationResolution"},{"$ref":"#/components/schemas/OperatorSelectedResolution"}],"discriminator":{"propertyName":"method","mapping":{"authoritative_identifier":"#/components/schemas/AuthoritativeIdentifierResolution","unique_sourced_association":"#/components/schemas/UniqueSourcedAssociationResolution","operator_selected":"#/components/schemas/OperatorSelectedResolution"}}},"AuthoritativeIdentifierResolution":{"type":"object","properties":{"method":{"type":"string","enum":["authoritative_identifier"]},"selectedEntity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"policyVersion":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"resolvedAt":{"type":"string","format":"date-time"}},"required":["method","selectedEntity","evidenceRefs","policyVersion","resolvedAt"],"additionalProperties":false},"UniqueSourcedAssociationResolution":{"type":"object","properties":{"method":{"type":"string","enum":["unique_sourced_association"]},"selectedEntity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"policyVersion":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"resolvedAt":{"type":"string","format":"date-time"}},"required":["method","selectedEntity","evidenceRefs","policyVersion","resolvedAt"],"additionalProperties":false},"OperatorSelectedResolution":{"type":"object","properties":{"method":{"type":"string","enum":["operator_selected"]},"selectedEntity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"policyVersion":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"resolvedAt":{"type":"string","format":"date-time"}},"required":["method","selectedEntity","evidenceRefs","policyVersion","resolvedAt"],"additionalProperties":false},"NotFoundCompanySearchResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_search"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"outcome":{"type":"string","enum":["not_found"]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CompanyCandidate"},"maxItems":0},"resolution":{"$ref":"#/components/schemas/UnresolvedCandidateResolution"},"totalResults":{"type":"number","enum":[0]},"truncated":{"type":"boolean","enum":[false]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","jurisdiction","query","outcome","candidates","resolution","totalResults","truncated","evidenceRefs"],"additionalProperties":false},"UnresolvedCandidateResolution":{"type":"object","properties":{"method":{"type":"string","enum":["unresolved"]},"selectedEntity":{"type":"null"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":0},"policyVersion":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"resolvedAt":{"type":"null"}},"required":["method","selectedEntity","evidenceRefs","policyVersion","resolvedAt"],"additionalProperties":false},"AmbiguousCompanySearchResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_search"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CompanyCandidate"},"minItems":1,"maxItems":100},"totalResults":{"type":["integer","null"],"exclusiveMinimum":0},"truncated":{"type":"boolean","enum":[false]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"outcome":{"type":"string","enum":["ambiguous"]},"resolution":{"$ref":"#/components/schemas/UnresolvedCandidateResolution"}},"required":["kind","jurisdiction","query","candidates","totalResults","truncated","evidenceRefs","outcome","resolution"],"additionalProperties":false},"PartialCompanySearchResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_search"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"outcome":{"type":"string","enum":["partial"]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CompanyCandidate"},"minItems":1,"maxItems":100},"resolution":{"$ref":"#/components/schemas/UnresolvedCandidateResolution"},"totalResults":{"type":["integer","null"],"exclusiveMinimum":0},"truncated":{"type":"boolean","enum":[true]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","jurisdiction","query","outcome","candidates","resolution","totalResults","truncated","evidenceRefs"],"additionalProperties":false},"ConflictingCompanySearchResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_search"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CompanyCandidate"},"minItems":1,"maxItems":100},"totalResults":{"type":["integer","null"],"exclusiveMinimum":0},"truncated":{"type":"boolean","enum":[false]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"outcome":{"type":"string","enum":["conflicting"]},"resolution":{"$ref":"#/components/schemas/CandidateResolution"}},"required":["kind","jurisdiction","query","candidates","totalResults","truncated","evidenceRefs","outcome","resolution"],"additionalProperties":false},"CandidateResolution":{"oneOf":[{"$ref":"#/components/schemas/AuthoritativeIdentifierResolution"},{"$ref":"#/components/schemas/UniqueSourcedAssociationResolution"},{"$ref":"#/components/schemas/OperatorSelectedResolution"},{"$ref":"#/components/schemas/UnresolvedCandidateResolution"}],"discriminator":{"propertyName":"method","mapping":{"authoritative_identifier":"#/components/schemas/AuthoritativeIdentifierResolution","unique_sourced_association":"#/components/schemas/UniqueSourcedAssociationResolution","operator_selected":"#/components/schemas/OperatorSelectedResolution","unresolved":"#/components/schemas/UnresolvedCandidateResolution"}}},"UnsupportedCompanySearchResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_search"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"outcome":{"type":"string","enum":["unsupported"]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CompanyCandidate"},"maxItems":0},"resolution":{"$ref":"#/components/schemas/UnresolvedCandidateResolution"},"totalResults":{"type":"null"},"truncated":{"type":"boolean","enum":[false]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":0}},"required":["kind","jurisdiction","query","outcome","candidates","resolution","totalResults","truncated","evidenceRefs"],"additionalProperties":false},"UnavailableCompanySearchResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_search"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"outcome":{"type":"string","enum":["source_unavailable"]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CompanyCandidate"},"maxItems":0},"resolution":{"$ref":"#/components/schemas/UnresolvedCandidateResolution"},"totalResults":{"type":"null"},"truncated":{"type":"boolean"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","jurisdiction","query","outcome","candidates","resolution","totalResults","truncated","evidenceRefs"],"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},"PublicCompanyResolutionEnvelopeV2":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["2026-09-07"]},"operation":{"$ref":"#/components/schemas/VerificationOperationReceipt"},"subject":{"type":"object","properties":{"search":{"$ref":"#/components/schemas/CompanySearchSubject"}},"required":["search"],"additionalProperties":false},"result":{"$ref":"#/components/schemas/CompanyResolutionResultV2"},"usage":{"$ref":"#/components/schemas/VerificationUsageSettlement"}},"required":["schemaVersion","operation","subject","result","usage"],"additionalProperties":false},"VerificationOperationReceipt":{"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":{"$ref":"#/components/schemas/VerificationEnvironment"},"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},"CompanyResolutionResultV2":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["2026-09-07"]},"resolutionPlanVersion":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"eligibleStageIds":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"kind":{"type":"string","enum":["company_resolution"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"query":{"type":"string","minLength":2,"maxLength":160},"outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unsupported"]},"resolutionState":{"type":["string","null"],"enum":["authority_confirmed","source_attributed","corroborated","company_claimed","derived_candidate","discovered","conflicting",null]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CompanyResolutionCandidateV2"},"maxItems":100},"discoveryLeads":{"type":"array","items":{"$ref":"#/components/schemas/CompanyDiscoveryLeadV2"},"maxItems":100},"sourceTrail":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionSourceTrailEntryV2"},"maxItems":100},"discoveryAttempts":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryAttemptV2"},"maxItems":20},"locatorConfirmations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"stageId":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"discoveryAttemptId":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"orderedBy":{"type":"object","properties":{"legalNameWeight":{"type":"number","enum":[2]},"brandWeight":{"type":"number","enum":[1]}},"required":["legalNameWeight","brandWeight"],"additionalProperties":false},"steps":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","exclusiveMinimum":0,"maximum":100},"identifier":{"type":"object","properties":{"family":{"type":"string","enum":["it_piva","fr_siren","fr_siret","fr_vat","es_vat","gb_company_number","de_ust_idnr","de_hrb","lu_vat","lu_rcs"]},"value":{"type":"string","minLength":1,"maxLength":100},"normalized":{"type":"string","minLength":1,"maxLength":100},"checksumValid":{"oneOf":[{"type":"boolean"},{"type":"string","enum":["n-a"]}]}},"required":["family","value","normalized","checksumValid"],"additionalProperties":false},"signals":{"type":"object","properties":{"legalNameHit":{"type":"boolean"},"brandHit":{"type":"boolean"}},"required":["legalNameHit","brandHit"],"additionalProperties":false},"confirmer":{"type":"object","properties":{"sourceId":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"outcome":{"type":"string","enum":["confirmed","no_match","unavailable","invalid"]},"officialName":{"type":["string","null"],"maxLength":500},"nameRelation":{"type":"string","enum":["matches_legal_name","brand_contained","different","anonymized"]},"checkedAt":{"type":"string","format":"date-time"}},"required":["sourceId","outcome","officialName","nameRelation","checkedAt"],"additionalProperties":false}},"required":["rank","identifier","signals","confirmer"],"additionalProperties":false},"maxItems":6},"outcome":{"type":"string","enum":["confirmed_intended","vat_valid_identity_corroborated","vat_valid_identity_unconfirmed","candidate_unresolved","confirmed_other_entity"]},"confirmedRank":{"type":["integer","null"],"exclusiveMinimum":0,"maximum":100},"confirmedIdentifier":{"type":["string","null"],"minLength":1,"maxLength":100},"confirmedOfficialName":{"type":["string","null"],"minLength":1,"maxLength":500},"attemptedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"costMicros":{"type":"number","enum":[0]}},"required":["id","stageId","jurisdiction","discoveryAttemptId","orderedBy","steps","outcome","confirmedRank","confirmedIdentifier","confirmedOfficialName","attemptedAt","completedAt","costMicros"],"additionalProperties":false},"maxItems":20},"exhaustedLayers":{"type":"array","items":{"type":"string","enum":["reusable_evidence","primary_public_source","identifier_bridge","serp_discovery","independent_page_retrieval","browser_retrieval","proxy_transport","opencorporates_locator","vat_validation","reconciliation"]},"maxItems":20},"incompleteLayers":{"type":"array","items":{"type":"string","enum":["reusable_evidence","primary_public_source","identifier_bridge","serp_discovery","independent_page_retrieval","browser_retrieval","proxy_transport","opencorporates_locator","vat_validation","reconciliation"]},"maxItems":20},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionEvidenceV2"},"maxItems":500},"totalCostMicros":{"type":"integer","minimum":0}},"required":["schemaVersion","resolutionPlanVersion","eligibleStageIds","kind","jurisdiction","query","outcome","resolutionState","candidates","discoveryLeads","sourceTrail","discoveryAttempts","exhaustedLayers","incompleteLayers","evidence","totalCostMicros"],"additionalProperties":false},"CompanyResolutionCandidateV2":{"type":"object","properties":{"rank":{"type":"integer","exclusiveMinimum":0,"maximum":100},"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"resolutionState":{"type":"string","enum":["authority_confirmed","source_attributed","corroborated","company_claimed","derived_candidate","discovered","conflicting"]},"identityEvidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"identityDiscoveryRefs":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryReferenceV2"},"maxItems":100},"fields":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionFieldV2"},"minItems":1,"maxItems":100},"missingFields":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionMissingFieldV2"},"maxItems":100},"vatPresence":{"$ref":"#/components/schemas/VatPresenceV2"},"vatCandidates":{"type":"array","items":{"$ref":"#/components/schemas/VatCandidateV2"},"maxItems":100},"facts":{"$ref":"#/components/schemas/CompanyFactsV1"}},"required":["rank","entity","resolutionState","identityEvidenceRefs","identityDiscoveryRefs","fields","missingFields","vatPresence","vatCandidates"],"additionalProperties":false},"ResolutionDiscoveryReferenceV2":{"type":"object","properties":{"attemptId":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"resultRank":{"type":"integer","exclusiveMinimum":0,"maximum":100}},"required":["attemptId","resultRank"],"additionalProperties":false},"ResolutionFieldV2":{"oneOf":[{"type":"object","properties":{"field":{"type":"string","enum":["registry_id","legal_name","registered_address","legal_status","legal_form","domestic_tax_id"]},"value":{"type":"string","minLength":1,"maxLength":1000},"resolutionState":{"type":"string","enum":["authority_confirmed","source_attributed","corroborated","company_claimed","derived_candidate","discovered","conflicting"]},"observedAt":{"type":["string","null"],"format":"date-time"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"discoveryRefs":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryReferenceV2"},"maxItems":100}},"required":["field","value","resolutionState","observedAt","evidenceRefs","discoveryRefs"],"additionalProperties":false},{"type":"object","properties":{"field":{"type":"string","enum":["country"]},"value":{"type":"string","pattern":"^[A-Z]{2}$"},"resolutionState":{"type":"string","enum":["authority_confirmed","source_attributed","corroborated","company_claimed","derived_candidate","discovered","conflicting"]},"observedAt":{"type":["string","null"],"format":"date-time"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"discoveryRefs":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryReferenceV2"},"maxItems":100}},"required":["field","value","resolutionState","observedAt","evidenceRefs","discoveryRefs"],"additionalProperties":false},{"type":"object","properties":{"field":{"type":"string","enum":["vat_presence"]},"value":{"type":"string","enum":["confirmed_present","indicated_present","confirmed_absent","unknown","conflicting"]},"resolutionState":{"type":"string","enum":["authority_confirmed","source_attributed","corroborated","company_claimed","derived_candidate","discovered","conflicting"]},"observedAt":{"type":["string","null"],"format":"date-time"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"discoveryRefs":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryReferenceV2"},"maxItems":100}},"required":["field","value","resolutionState","observedAt","evidenceRefs","discoveryRefs"],"additionalProperties":false},{"type":"object","properties":{"field":{"type":"string","enum":["vat_association"]},"value":{"type":"boolean"},"resolutionState":{"type":"string","enum":["authority_confirmed","source_attributed","corroborated","company_claimed","derived_candidate","discovered","conflicting"]},"observedAt":{"type":["string","null"],"format":"date-time"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"discoveryRefs":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryReferenceV2"},"maxItems":100}},"required":["field","value","resolutionState","observedAt","evidenceRefs","discoveryRefs"],"additionalProperties":false},{"type":"object","properties":{"field":{"type":"string","enum":["vat_validity"]},"value":{"type":"string","enum":["valid","invalid"]},"resolutionState":{"type":"string","enum":["authority_confirmed","source_attributed","corroborated","company_claimed","derived_candidate","discovered","conflicting"]},"observedAt":{"type":["string","null"],"format":"date-time"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"discoveryRefs":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryReferenceV2"},"maxItems":100}},"required":["field","value","resolutionState","observedAt","evidenceRefs","discoveryRefs"],"additionalProperties":false}]},"ResolutionMissingFieldV2":{"type":"object","properties":{"field":{"type":"string","enum":["registry_id","legal_name","registered_address","country","legal_status","legal_form","domestic_tax_id","vat_presence","vat_association","vat_validity"]},"reason":{"type":"string","enum":["not_exposed_by_source","not_found","withheld","unsupported","source_unavailable","not_attempted","conflicting"]},"observedAt":{"type":["string","null"],"format":"date-time"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"discoveryRefs":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryReferenceV2"},"maxItems":100}},"required":["field","reason","observedAt","evidenceRefs","discoveryRefs"],"additionalProperties":false},"VatPresenceV2":{"type":"object","properties":{"state":{"type":"string","enum":["confirmed_present","indicated_present","confirmed_absent","unknown","conflicting"]},"identifierDisclosure":{"type":"string","enum":["disclosed","withheld","not_found","unknown"]},"resolutionState":{"type":["string","null"],"enum":["authority_confirmed","source_attributed","corroborated","company_claimed","derived_candidate","discovered","conflicting",null]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100}},"required":["state","identifierDisclosure","resolutionState","evidenceRefs"],"additionalProperties":false},"VatCandidateV2":{"type":"object","properties":{"vatNumber":{"type":"string","pattern":"^[A-Z]{2}[A-Z0-9+*.]{2,32}$"},"taxJurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"basis":{"type":"string","enum":["official_dataset","official_registry","derived_rule","company_claim","private_index","corroborated_public"]},"resolutionState":{"type":"string","enum":["authority_confirmed","source_attributed","corroborated","company_claimed","derived_candidate","discovered","conflicting"]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"entityAssociation":{"$ref":"#/components/schemas/VatEntityAssociationV2"},"derivation":{"$ref":"#/components/schemas/VatIdentifierDerivationV2"},"validation":{"oneOf":[{"type":"object","properties":{"state":{"type":"string","enum":["not_requested"]},"checkedAt":{"type":"null"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100}},"required":["state","checkedAt","evidenceRefs"],"additionalProperties":false},{"type":"object","properties":{"state":{"type":"string","enum":["valid","invalid"]},"checkedAt":{"type":"string","format":"date-time"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["state","checkedAt","evidenceRefs"],"additionalProperties":false},{"type":"object","properties":{"state":{"type":"string","enum":["source_unavailable","unsupported"]},"checkedAt":{"type":["string","null"],"format":"date-time"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100}},"required":["state","checkedAt","evidenceRefs"],"additionalProperties":false}]}},"required":["vatNumber","taxJurisdiction","basis","resolutionState","evidenceRefs","derivation","validation"],"additionalProperties":false},"VatEntityAssociationV2":{"type":"object","properties":{"relationship":{"type":"string","enum":["direct_registration","foreign_registration","branch_registration","vat_group_membership","fiscal_representative"]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["relationship","evidenceRefs"],"additionalProperties":false},"VatIdentifierDerivationV2":{"type":["object","null"],"properties":{"ruleId":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"ruleVersion":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"inputIdentifier":{"type":"object","properties":{"type":{"type":"string","enum":["registry_id","domestic_tax_id"]},"value":{"type":"string","minLength":1,"maxLength":160}},"required":["type","value"],"additionalProperties":false},"normalizedInput":{"type":"string","minLength":1,"maxLength":160},"assumptions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"minItems":1,"maxItems":32},"officialReference":{"type":"string","format":"uri"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["ruleId","ruleVersion","inputIdentifier","normalizedInput","assumptions","officialReference","evidenceRefs"],"additionalProperties":false},"CompanyFactsV1":{"type":"object","properties":{"schema_version":{"type":"string","enum":["company-facts.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/CompanyFactObservationV1"},"minItems":1,"maxItems":200},"truncated":{"type":"boolean"}},"required":["schema_version","subject","observations"],"additionalProperties":false},"CompanyFactObservationV1":{"type":"object","properties":{"fact":{"$ref":"#/components/schemas/CompanyFactV1"},"evidence_refs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"minItems":1,"maxItems":100},"state":{"type":"string","enum":["authority_confirmed","source_attributed","company_claimed","corroborated_public","synthetic"]},"observed_at":{"type":"string","format":"date-time"},"source_record_updated_at":{"type":["string","null"],"minLength":1,"maxLength":2000}},"required":["fact","evidence_refs","state","observed_at","source_record_updated_at"],"additionalProperties":false},"CompanyFactV1":{"oneOf":[{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":2000},"language":{"type":"string","minLength":1,"maxLength":160}},"required":["native_path","kind","role","value"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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}$"},"issuer":{"type":"string","minLength":1,"maxLength":2000}},"required":["native_path","kind","role","scheme","value","jurisdiction"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":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":["native_path","kind","role","raw"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":2000}},"required":["native_path","kind","scheme"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":2000}},"required":["native_path","kind","event"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":2000},"authority":{"type":"string","minLength":1,"maxLength":2000}},"required":["native_path","kind","register","reference"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":2000},"primary":{"type":"boolean"}},"required":["native_path","kind","scheme","code"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":["native_path","kind","basis"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":2000},"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":["native_path","kind","role"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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"]},"value":{"type":"string","minLength":1,"maxLength":2000}},"required":["native_path","kind","channel","value"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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","minLength":1,"maxLength":2000}},"required":["native_path","kind","role","value"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":2000},"url":{"type":"string","format":"uri"},"published_on":{"type":"string","format":"date"}},"required":["native_path","kind","role","reference"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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":["native_path","kind","indicator","status"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"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"},"regime":{"type":"string","minLength":1,"maxLength":160}},"required":["native_path","kind","purpose","scope","restricted","regime"],"additionalProperties":false},{"type":"object","properties":{"native_path":{"type":"string","minLength":1,"maxLength":2000},"raw_value":{"type":"string","maxLength":8192},"valid_from":{"type":"string","format":"date"},"valid_to":{"type":"string","format":"date"},"kind":{"type":"string","enum":["country_detail"]},"detail":{"$ref":"#/components/schemas/CompanyCountryDetailV1"}},"required":["native_path","kind","detail"],"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},"CompanyCountryDetailV1":{"oneOf":[{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["CZ"]},"schema_version":{"type":"string","enum":["cz-vat.v1"]},"unreliable_payer":{"type":"boolean"}},"required":["jurisdiction","schema_version","unreliable_payer"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["PL"]},"schema_version":{"type":"string","enum":["pl-ksef.v1"]},"jst":{"type":"boolean"},"gv":{"type":"boolean"}},"required":["jurisdiction","schema_version"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["RO"]},"schema_version":{"type":"string","enum":["ro-correspondence.v1"]},"dualist_sa_notice":{"type":"string","minLength":1,"maxLength":2000}},"required":["jurisdiction","schema_version","dualist_sa_notice"],"additionalProperties":false}]},"CompanyDiscoveryLeadV2":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"label":{"type":"string","minLength":1,"maxLength":500},"resolutionState":{"type":"string","enum":["discovered"]},"unverifiedEntityHint":{"oneOf":[{"$ref":"#/components/schemas/LegalEntityIdentity"},{"type":"null"}]},"discoveryRefs":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryReferenceV2"},"minItems":1,"maxItems":100}},"required":["id","jurisdiction","label","resolutionState","unverifiedEntityHint","discoveryRefs"],"additionalProperties":false},"ResolutionSourceTrailEntryV2":{"type":"object","properties":{"order":{"type":"integer","exclusiveMinimum":0,"maximum":100},"stageId":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"layer":{"type":"string","enum":["reusable_evidence","primary_public_source","identifier_bridge","serp_discovery","independent_page_retrieval","browser_retrieval","proxy_transport","opencorporates_locator","vat_validation","reconciliation"]},"sourceId":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"transport":{"type":"string","enum":["cache","official_snapshot","direct_api","direct_http","browser","proxy","search_provider","not_applicable"]},"completion":{"type":"string","enum":["complete","incomplete","skipped"]},"attemptedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"observedAt":{"type":["string","null"],"format":"date-time"},"producedEvidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":100},"discoveryAttemptRef":{"oneOf":[{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},{"type":"null"}]},"continuationReason":{"type":["string","null"],"minLength":1,"maxLength":500},"costMicros":{"type":"integer","minimum":0}},"required":["order","stageId","layer","sourceId","transport","completion","attemptedAt","completedAt","observedAt","producedEvidenceRefs","discoveryAttemptRef","continuationReason","costMicros"],"additionalProperties":false},"ResolutionDiscoveryAttemptV2":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"layer":{"type":"string","enum":["serp_discovery","opencorporates_locator"]},"provider":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"queryFingerprint":{"type":"string","pattern":"^hmac-sha256:[a-f0-9]{64}$"},"allowedDomains":{"type":"array","items":{"type":"string","minLength":1,"maxLength":253,"pattern":"^[A-Za-z0-9.-]+$"},"maxItems":100},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","exclusiveMinimum":0,"maximum":100},"url":{"type":"string","format":"uri"},"domain":{"type":"string","minLength":1,"maxLength":253,"pattern":"^[A-Za-z0-9.-]+$"},"title":{"type":["string","null"],"minLength":1,"maxLength":500},"snippet":{"type":["string","null"],"minLength":1,"maxLength":1000},"sourceClass":{"type":"string","enum":["reviewed","open"]}},"required":["rank","url","domain","title"],"additionalProperties":false},"maxItems":100},"attemptedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"outcome":{"type":"string","enum":["results","no_results","source_unavailable","budget_exhausted"]},"components":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"outcome":{"type":"string","enum":["results","no_results","source_unavailable","budget_exhausted"]},"resultsCount":{"type":"integer","minimum":0},"costMicros":{"type":"integer","minimum":0},"reasonCode":{"type":["string","null"],"minLength":1,"maxLength":200}},"required":["provider","outcome","resultsCount","costMicros","reasonCode"],"additionalProperties":false},"maxItems":4},"costMicros":{"type":"integer","minimum":0}},"required":["id","layer","provider","queryFingerprint","allowedDomains","results","attemptedAt","completedAt","outcome","costMicros"],"additionalProperties":false},"ResolutionEvidenceV2":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"source":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"name":{"type":"string","minLength":1,"maxLength":240},"classification":{"type":"string","enum":["official_register","official_tax_authority","official_dataset","licensed_provider","private_index","company_website","sandbox_fixture"]},"independenceKey":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"url":{"type":"string","format":"uri"}},"required":["id","name","classification","independenceKey","url"],"additionalProperties":false},"sourceRecordId":{"type":["string","null"],"minLength":1,"maxLength":240},"subject":{"$ref":"#/components/schemas/NullableVerificationSubjectReference"},"capability":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"authorityScope":{"type":["string","null"],"minLength":1,"maxLength":240},"attemptedAt":{"type":["string","null"],"format":"date-time"},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"servedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetPublishedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetImportedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetEffectiveAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"deliveryForm":{"type":"string","enum":["live_source_call","official_snapshot","cached_observation","coalesced_observation","sandbox_fixture"]},"rightsReference":{"type":["string","null"],"format":"uri"},"rightsPolicyVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"parserVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"coveragePolicyVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"nativeStatus":{"type":["string","null"],"maxLength":500},"nativeValue":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"completion":{"$ref":"#/components/schemas/EvidenceCompletion"},"warnings":{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"maxItems":64},"suppression":{"type":"object","properties":{"suppressed":{"type":"boolean"},"reason":{"type":["string","null"],"minLength":1,"maxLength":500},"effectiveAt":{"type":["string","null"],"format":"date-time"}},"required":["suppressed","reason","effectiveAt"],"additionalProperties":false},"contentDigest":{"type":["string","null"],"pattern":"^sha256:[a-f0-9]{64}$"},"proofReference":{"type":["string","null"],"minLength":1,"maxLength":500},"metadataCompleteness":{"type":"string","enum":["complete","legacy_partial"]},"transport":{"type":"string","enum":["cache","official_snapshot","direct_api","direct_http","browser","proxy","search_provider","not_applicable"]},"transportDetails":{"type":["object","null"],"properties":{"provider":{"type":"string","enum":["bright_data","iproyal"]},"region":{"type":"string","pattern":"^[A-Z]{2}$"},"attempts":{"type":"number","enum":[1]},"responseBytes":{"type":"integer","minimum":0},"costMicros":{"type":"integer","minimum":0}},"required":["provider","region","attempts","responseBytes","costMicros"],"additionalProperties":false}},"required":["id","source","sourceRecordId","subject","capability","environment","authorityScope","attemptedAt","observedAt","retrievedAt","servedAt","sourceRecordUpdatedAt","datasetPublishedAt","datasetImportedAt","datasetEffectiveAt","deliveryForm","rightsReference","rightsPolicyVersion","parserVersion","coveragePolicyVersion","nativeStatus","nativeValue","completion","warnings","suppression","contentDigest","proofReference","metadataCompleteness","transport"],"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},"PublicCompanyWebSearchEnvelopeV2":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["2026-09-07"]},"operation":{"$ref":"#/components/schemas/VerificationOperationReceipt"},"subject":{"type":"object","properties":{"search":{"type":"object","properties":{"query":{"type":"string"},"jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}}},"required":["query"]}},"required":["search"],"additionalProperties":false},"result":{"$ref":"#/components/schemas/ReconciledCompanySearchResultV2"},"usage":{"$ref":"#/components/schemas/VerificationUsageSettlement"}},"required":["schemaVersion","operation","subject","result","usage"],"additionalProperties":false},"ReconciledCompanySearchResultV2":{"type":"object","properties":{"outcome":{"type":"string","enum":["resolved","candidates_found","not_found","source_unavailable"]},"reconciledProfile":{"$ref":"#/components/schemas/ReconciledCompanyProfileV2"},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/ReconciledCompanyProfileV2"}},"reconciliationBasis":{"type":"object","properties":{"selectedVatBasis":{"type":"string","enum":["supplied_identifier","registry_identifier","vies_name_match","first_valid_candidate","none"]},"matchedDomains":{"type":"array","items":{"type":"string"}},"sourcesConsulted":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string"},"kind":{"type":"string","enum":["official_register","indexed_source","search_locator","tax_authority"]},"recordsReturned":{"type":"integer","minimum":0}},"required":["sourceId","kind","recordsReturned"]}}},"required":["selectedVatBasis","matchedDomains","sourcesConsulted"],"additionalProperties":false},"costMicros":{"type":"integer","minimum":0}},"required":["outcome","reconciledProfile","candidates","reconciliationBasis","costMicros"],"additionalProperties":false},"ReconciledCompanyProfileV2":{"type":["object","null"],"properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"},"legalForm":{"type":["string","null"]},"legalEntity":{"$ref":"#/components/schemas/ReconciledLegalEntityV2"},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"address":{"$ref":"#/components/schemas/ReconciledAddressV2"},"companyId":{"type":["string","null"]},"taxId":{"type":["string","null"]},"lei":{"type":["string","null"]},"vatId":{"type":["string","null"]},"vatVies":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["valid","invalid","unavailable"]},"name":{"type":["string","null"]},"address":{"type":["string","null"]}},"required":["status","name","address"]},"confidence":{"type":"string","enum":["authority_confirmed","corroborated","indexed_source","web_extracted"]}},"required":["legalName","normalizedName","legalForm","jurisdiction","address","companyId","taxId","lei","vatId","vatVies","confidence"],"additionalProperties":false},"ReconciledAddressV2":{"type":"object","properties":{"raw":{"type":["string","null"]},"normalized":{"type":["object","null"],"properties":{"street":{"type":"string"},"city":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["country"]}},"required":["raw","normalized"],"additionalProperties":false},"PublicCompanyWebSearchInputV2":{"type":"object","properties":{"query":{"type":"string","minLength":2,"maxLength":160},"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},"PublicCompanyVerificationEnvelope":{"type":"object","properties":{"schemaVersion":{"$ref":"#/components/schemas/PublicVerificationSchemaVersion"},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["company_verification"]},"status":{"type":"string","enum":["completed"]},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"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},"subject":{"$ref":"#/components/schemas/CompanyOperationSubject"},"result":{"$ref":"#/components/schemas/CompanyVerificationResult"},"claims":{"type":"array","items":{"$ref":"#/components/schemas/VerificationClaim"},"maxItems":500},"relationships":{"type":"array","items":{"$ref":"#/components/schemas/VerificationRelationship"},"maxItems":500},"conflicts":{"type":"array","items":{"$ref":"#/components/schemas/VerificationConflict"},"maxItems":100},"issues":{"type":"array","items":{"$ref":"#/components/schemas/VerificationIssue"},"maxItems":100},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/VerificationEvidence"},"maxItems":500},"staleEvidence":{"type":"array","items":{"$ref":"#/components/schemas/VerificationEvidence"},"maxItems":500},"freshness":{"$ref":"#/components/schemas/VerificationFreshness"},"usage":{"$ref":"#/components/schemas/VerificationUsageSettlement"}},"required":["schemaVersion","operation","subject","result","claims","relationships","conflicts","issues","evidence","staleEvidence","freshness","usage"],"additionalProperties":false},"CompanyOperationSubject":{"type":"object","properties":{"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"customerAccount":{"$ref":"#/components/schemas/CustomerAccountIdentity"}},"required":["entity"],"additionalProperties":false},"CompanyVerificationResult":{"oneOf":[{"$ref":"#/components/schemas/FoundCompanyVerificationResult"},{"$ref":"#/components/schemas/NotFoundCompanyVerificationResult"},{"$ref":"#/components/schemas/ConflictingCompanyVerificationResult"},{"$ref":"#/components/schemas/UnsupportedCompanyVerificationResult"},{"$ref":"#/components/schemas/UnavailableCompanyVerificationResult"}],"discriminator":{"propertyName":"outcome","mapping":{"found":"#/components/schemas/FoundCompanyVerificationResult","not_found":"#/components/schemas/NotFoundCompanyVerificationResult","conflicting":"#/components/schemas/ConflictingCompanyVerificationResult","unsupported":"#/components/schemas/UnsupportedCompanyVerificationResult","source_unavailable":"#/components/schemas/UnavailableCompanyVerificationResult"}}},"FoundCompanyVerificationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_verification"]},"outcome":{"type":"string","enum":["found"]},"company":{"$ref":"#/components/schemas/VerifiedCompanyProfile"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","outcome","company","evidenceRefs"],"additionalProperties":false},"VerifiedCompanyProfile":{"type":"object","properties":{"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"legalName":{"type":["string","null"],"maxLength":500},"registeredAddress":{"type":"object","properties":{"fullAddress":{"type":["string","null"],"maxLength":1000},"postalCode":{"type":["string","null"],"maxLength":80},"locality":{"type":["string","null"],"maxLength":240},"countryCode":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"countryLabel":{"type":["string","null"],"maxLength":240}},"required":["fullAddress","postalCode","locality","countryCode","countryLabel"],"additionalProperties":false},"status":{"type":"string","enum":["active","ceased","unknown"]},"rawStatus":{"type":["string","null"],"maxLength":500},"statusMeaning":{"type":"string","minLength":1,"maxLength":1000},"legalFormCode":{"type":["string","null"],"maxLength":160},"disclosure":{"type":"string","enum":["public","partial","unknown"]},"nationalVatRegistration":{"type":["object","null"],"properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"status":{"type":"string","enum":["registered","not_registered","unknown"]},"registrationDate":{"type":["string","null"],"maxLength":500},"deregistrationDate":{"type":["string","null"],"maxLength":500},"rawStatus":{"type":["string","null"],"maxLength":500},"meaning":{"type":"string","minLength":1,"maxLength":1000}},"required":["jurisdiction","status","registrationDate","deregistrationDate","rawStatus","meaning"],"additionalProperties":false},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["entity","legalName","registeredAddress","status","rawStatus","statusMeaning","legalFormCode","disclosure","evidenceRefs"],"additionalProperties":false},"NotFoundCompanyVerificationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_verification"]},"outcome":{"type":"string","enum":["not_found"]},"company":{"type":"null"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","outcome","company","evidenceRefs"],"additionalProperties":false},"ConflictingCompanyVerificationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_verification"]},"outcome":{"type":"string","enum":["conflicting"]},"company":{"$ref":"#/components/schemas/VerifiedCompanyProfile"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":2,"maxItems":100}},"required":["kind","outcome","company","evidenceRefs"],"additionalProperties":false},"UnsupportedCompanyVerificationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_verification"]},"outcome":{"type":"string","enum":["unsupported"]},"company":{"type":"null"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":0}},"required":["kind","outcome","company","evidenceRefs"],"additionalProperties":false},"UnavailableCompanyVerificationResult":{"type":"object","properties":{"kind":{"type":"string","enum":["company_verification"]},"outcome":{"type":"string","enum":["source_unavailable"]},"company":{"type":"null"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","outcome","company","evidenceRefs"],"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},"PublicVatDiscoveryEnvelope":{"type":"object","properties":{"schemaVersion":{"$ref":"#/components/schemas/PublicVerificationSchemaVersion"},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["vat_discovery"]},"status":{"type":"string","enum":["completed"]},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"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},"subject":{"$ref":"#/components/schemas/CompanyOperationSubject"},"result":{"$ref":"#/components/schemas/VatDiscoveryResult"},"claims":{"type":"array","items":{"$ref":"#/components/schemas/VerificationClaim"},"maxItems":500},"relationships":{"type":"array","items":{"$ref":"#/components/schemas/VerificationRelationship"},"maxItems":500},"conflicts":{"type":"array","items":{"$ref":"#/components/schemas/VerificationConflict"},"maxItems":100},"issues":{"type":"array","items":{"$ref":"#/components/schemas/VerificationIssue"},"maxItems":100},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/VerificationEvidence"},"maxItems":500},"staleEvidence":{"type":"array","items":{"$ref":"#/components/schemas/VerificationEvidence"},"maxItems":500},"freshness":{"$ref":"#/components/schemas/VerificationFreshness"},"usage":{"$ref":"#/components/schemas/VerificationUsageSettlement"}},"required":["schemaVersion","operation","subject","result","claims","relationships","conflicts","issues","evidence","staleEvidence","freshness","usage"],"additionalProperties":false},"VatDiscoveryResult":{"oneOf":[{"$ref":"#/components/schemas/FoundVatDiscoveryResult"},{"$ref":"#/components/schemas/NotFoundVatDiscoveryResult"},{"$ref":"#/components/schemas/AmbiguousVatDiscoveryResult"},{"$ref":"#/components/schemas/ConflictingVatDiscoveryResult"},{"$ref":"#/components/schemas/UnsupportedVatDiscoveryResult"},{"$ref":"#/components/schemas/UnavailableVatDiscoveryResult"}],"discriminator":{"propertyName":"outcome","mapping":{"found":"#/components/schemas/FoundVatDiscoveryResult","not_found":"#/components/schemas/NotFoundVatDiscoveryResult","ambiguous":"#/components/schemas/AmbiguousVatDiscoveryResult","conflicting":"#/components/schemas/ConflictingVatDiscoveryResult","unsupported":"#/components/schemas/UnsupportedVatDiscoveryResult","source_unavailable":"#/components/schemas/UnavailableVatDiscoveryResult"}}},"FoundVatDiscoveryResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_discovery"]},"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"company":{"$ref":"#/components/schemas/VerifiedCompanyProfile"},"associations":{"type":"array","items":{"$ref":"#/components/schemas/VatAssociation"},"minItems":1,"maxItems":100},"validations":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveredVatValidation"},"maxItems":1},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"outcome":{"type":"string","enum":["found"]}},"required":["kind","entity","company","associations","validations","evidenceRefs","outcome"],"additionalProperties":false},"VatAssociation":{"type":"object","properties":{"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"vatRegistration":{"$ref":"#/components/schemas/VatRegistrationIdentity"},"basis":{"type":"string","enum":["official_dataset","official_registry","licensed_provider","derived_rule","sandbox"]},"relationship":{"type":"string","enum":["direct_registration","foreign_registration","vat_group_membership"]},"resolutionState":{"type":"string","enum":["authority_confirmed","derived_candidate"]},"derivation":{"$ref":"#/components/schemas/VatAssociationDerivation"},"validityDate":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"issuedDate":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["entity","vatRegistration","basis","validityDate","issuedDate","evidenceRefs"],"additionalProperties":false},"VatAssociationDerivation":{"type":["object","null"],"properties":{"ruleId":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"ruleVersion":{"type":"string","minLength":1,"maxLength":80},"inputIdentifier":{"type":"object","properties":{"type":{"type":"string","enum":["registry_id","domestic_tax_id"]},"value":{"type":"string","minLength":1,"maxLength":160}},"required":["type","value"],"additionalProperties":false},"normalizedInput":{"type":"string","minLength":1,"maxLength":160},"assumptions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":2000},"minItems":1,"maxItems":20},"officialReference":{"type":"string","format":"uri"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["ruleId","ruleVersion","inputIdentifier","normalizedInput","assumptions","officialReference","evidenceRefs"],"additionalProperties":false},"DiscoveredVatValidation":{"oneOf":[{"$ref":"#/components/schemas/CompletedDiscoveredVatValidation"},{"$ref":"#/components/schemas/UnsupportedDiscoveredVatValidation"},{"$ref":"#/components/schemas/UnavailableDiscoveredVatValidation"}]},"CompletedDiscoveredVatValidation":{"type":"object","properties":{"vatRegistration":{"$ref":"#/components/schemas/VatRegistrationIdentity"},"legalName":{"type":["string","null"],"maxLength":500},"address":{"type":["string","null"],"maxLength":1000},"outcome":{"type":"string","enum":["valid","invalid"]},"checkedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["vatRegistration","legalName","address","outcome","checkedAt","cached","evidenceRefs"],"additionalProperties":false},"UnsupportedDiscoveredVatValidation":{"type":"object","properties":{"vatRegistration":{"$ref":"#/components/schemas/VatRegistrationIdentity"},"legalName":{"type":"null"},"address":{"type":"null"},"outcome":{"type":"string","enum":["unsupported"]},"checkedAt":{"type":"null"},"cached":{"type":"boolean","enum":[false]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":0}},"required":["vatRegistration","legalName","address","outcome","checkedAt","cached","evidenceRefs"],"additionalProperties":false},"UnavailableDiscoveredVatValidation":{"type":"object","properties":{"vatRegistration":{"$ref":"#/components/schemas/VatRegistrationIdentity"},"legalName":{"type":"null"},"address":{"type":"null"},"outcome":{"type":"string","enum":["source_unavailable"]},"checkedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean","enum":[false]},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["vatRegistration","legalName","address","outcome","checkedAt","cached","evidenceRefs"],"additionalProperties":false},"NotFoundVatDiscoveryResult":{"oneOf":[{"$ref":"#/components/schemas/MissingLegalEntityVatDiscoveryResult"},{"$ref":"#/components/schemas/MissingVatAssociationVatDiscoveryResult"}],"discriminator":{"propertyName":"notFoundScope","mapping":{"legal_entity":"#/components/schemas/MissingLegalEntityVatDiscoveryResult","vat_association":"#/components/schemas/MissingVatAssociationVatDiscoveryResult"}}},"MissingLegalEntityVatDiscoveryResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_discovery"]},"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"outcome":{"type":"string","enum":["not_found"]},"associations":{"type":"array","items":{"$ref":"#/components/schemas/VatAssociation"},"maxItems":0},"validations":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveredVatValidation"},"maxItems":0},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"notFoundScope":{"type":"string","enum":["legal_entity"]},"company":{"type":"null"}},"required":["kind","entity","outcome","associations","validations","evidenceRefs","notFoundScope","company"],"additionalProperties":false},"MissingVatAssociationVatDiscoveryResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_discovery"]},"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"outcome":{"type":"string","enum":["not_found"]},"associations":{"type":"array","items":{"$ref":"#/components/schemas/VatAssociation"},"maxItems":0},"validations":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveredVatValidation"},"maxItems":0},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"notFoundScope":{"type":"string","enum":["vat_association"]},"company":{"$ref":"#/components/schemas/VerifiedCompanyProfile"}},"required":["kind","entity","outcome","associations","validations","evidenceRefs","notFoundScope","company"],"additionalProperties":false},"AmbiguousVatDiscoveryResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_discovery"]},"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"company":{"$ref":"#/components/schemas/VerifiedCompanyProfile"},"associations":{"type":"array","items":{"$ref":"#/components/schemas/VatAssociation"},"minItems":1,"maxItems":100},"validations":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveredVatValidation"},"maxItems":1},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"outcome":{"type":"string","enum":["ambiguous"]}},"required":["kind","entity","company","associations","validations","evidenceRefs","outcome"],"additionalProperties":false},"ConflictingVatDiscoveryResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_discovery"]},"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"company":{"$ref":"#/components/schemas/VerifiedCompanyProfile"},"associations":{"type":"array","items":{"$ref":"#/components/schemas/VatAssociation"},"minItems":1,"maxItems":100},"validations":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveredVatValidation"},"maxItems":1},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"outcome":{"type":"string","enum":["conflicting"]}},"required":["kind","entity","company","associations","validations","evidenceRefs","outcome"],"additionalProperties":false},"UnsupportedVatDiscoveryResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_discovery"]},"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"company":{"type":"null"},"outcome":{"type":"string","enum":["unsupported"]},"associations":{"type":"array","items":{"$ref":"#/components/schemas/VatAssociation"},"maxItems":0},"validations":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveredVatValidation"},"maxItems":0},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"maxItems":0}},"required":["kind","entity","company","outcome","associations","validations","evidenceRefs"],"additionalProperties":false},"UnavailableVatDiscoveryResult":{"type":"object","properties":{"kind":{"type":"string","enum":["vat_discovery"]},"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"company":{"$ref":"#/components/schemas/NullableVerifiedCompanyProfile"},"outcome":{"type":"string","enum":["source_unavailable"]},"associations":{"type":"array","items":{"$ref":"#/components/schemas/VatAssociation"},"maxItems":0},"validations":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveredVatValidation"},"maxItems":0},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","entity","company","outcome","associations","validations","evidenceRefs"],"additionalProperties":false},"NullableVerifiedCompanyProfile":{"oneOf":[{"$ref":"#/components/schemas/VerifiedCompanyProfile"},{"type":"null"}]},"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},"CompanySearchCandidateSelectionResponseV1":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["2026-09-06"]},"id":{"type":"string","format":"uuid"},"searchOperationId":{"type":"string","format":"uuid"},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"candidateRank":{"type":"integer","exclusiveMinimum":0,"maximum":100},"resolution":{"$ref":"#/components/schemas/OperatorSelectedResolution"},"replayed":{"type":"boolean"}},"required":["schemaVersion","id","searchOperationId","environment","candidateRank","resolution","replayed"],"additionalProperties":false},"CompanySearchCandidateSelectionInputV1":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/VerificationEnvironment"},"candidate":{"$ref":"#/components/schemas/LegalEntityIdentity"}},"required":["mode","candidate"],"additionalProperties":false},"PublicVerificationHistoryPageV1":{"type":"object","properties":{"schemaVersion":{"$ref":"#/components/schemas/PublicVerificationSchemaVersion"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicVerificationEnvelopeV1"},"maxItems":50},"nextCursor":{"$ref":"#/components/schemas/PublicVerificationHistoryCursorV1"}},"required":["schemaVersion","items","nextCursor"],"additionalProperties":false},"PublicVerificationEnvelopeV1":{"oneOf":[{"$ref":"#/components/schemas/PublicVatValidationEnvelope"},{"$ref":"#/components/schemas/PublicCompanySearchEnvelope"},{"$ref":"#/components/schemas/PublicCompanyVerificationEnvelope"},{"$ref":"#/components/schemas/PublicVatDiscoveryEnvelope"}]},"PublicVerificationHistoryCursorV1":{"type":["string","null"],"minLength":1,"maxLength":512,"pattern":"^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$"},"PublicCompanyVerificationHistoryPageV2":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["2026-09-07"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicCompanyVerificationEnvelopeV2"},"maxItems":50},"nextCursor":{"$ref":"#/components/schemas/PublicVerificationHistoryCursorV1"}},"required":["schemaVersion","items","nextCursor"],"additionalProperties":false},"PublicCompanyVerificationEnvelopeV2":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["2026-09-07"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["company_verification"]},"status":{"type":"string","enum":["completed"]},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"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},"subject":{"$ref":"#/components/schemas/CompanyOperationSubject"},"result":{"$ref":"#/components/schemas/CompanyVerificationResultV2"},"claims":{"type":"array","items":{"$ref":"#/components/schemas/VerificationClaim"},"maxItems":500},"relationships":{"type":"array","items":{"$ref":"#/components/schemas/VerificationRelationship"},"maxItems":500},"conflicts":{"type":"array","items":{"$ref":"#/components/schemas/VerificationConflict"},"maxItems":100},"issues":{"type":"array","items":{"$ref":"#/components/schemas/VerificationIssue"},"maxItems":100},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"source":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"name":{"type":"string","minLength":1,"maxLength":240},"classification":{"type":["string","null"],"enum":["official_register","official_tax_authority","official_dataset","licensed_provider","private_index","company_website","sandbox_fixture",null]},"url":{"type":"string","format":"uri"},"independenceKey":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id","name","classification","url"],"additionalProperties":false},"sourceRecordId":{"type":["string","null"],"minLength":1,"maxLength":240},"subject":{"$ref":"#/components/schemas/NullableVerificationSubjectReference"},"capability":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"authorityScope":{"type":["string","null"],"minLength":1,"maxLength":240},"attemptedAt":{"type":["string","null"],"format":"date-time"},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"servedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetPublishedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetImportedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetEffectiveAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"deliveryForm":{"type":"string","enum":["live_source_call","official_snapshot","cached_observation","coalesced_observation","sandbox_fixture"]},"rightsReference":{"type":["string","null"],"format":"uri"},"rightsPolicyVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"parserVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"coveragePolicyVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"nativeStatus":{"type":["string","null"],"maxLength":500},"nativeValue":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"completion":{"$ref":"#/components/schemas/EvidenceCompletion"},"warnings":{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"maxItems":64},"suppression":{"type":"object","properties":{"suppressed":{"type":"boolean"},"reason":{"type":["string","null"],"minLength":1,"maxLength":500},"effectiveAt":{"type":["string","null"],"format":"date-time"}},"required":["suppressed","reason","effectiveAt"],"additionalProperties":false},"contentDigest":{"type":["string","null"],"pattern":"^sha256:[a-f0-9]{64}$"},"proofReference":{"type":["string","null"],"minLength":1,"maxLength":500},"metadataCompleteness":{"type":"string","enum":["complete","legacy_partial"]}},"required":["id","source","sourceRecordId","subject","capability","environment","authorityScope","attemptedAt","observedAt","retrievedAt","servedAt","sourceRecordUpdatedAt","datasetPublishedAt","datasetImportedAt","datasetEffectiveAt","deliveryForm","rightsReference","rightsPolicyVersion","parserVersion","coveragePolicyVersion","nativeStatus","nativeValue","completion","warnings","suppression","contentDigest","proofReference","metadataCompleteness"],"additionalProperties":false},"maxItems":500},"staleEvidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"source":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"name":{"type":"string","minLength":1,"maxLength":240},"classification":{"type":["string","null"],"enum":["official_register","official_tax_authority","official_dataset","licensed_provider","private_index","company_website","sandbox_fixture",null]},"url":{"type":"string","format":"uri"},"independenceKey":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id","name","classification","url"],"additionalProperties":false},"sourceRecordId":{"type":["string","null"],"minLength":1,"maxLength":240},"subject":{"$ref":"#/components/schemas/NullableVerificationSubjectReference"},"capability":{"type":"string","enum":["vat_validation","company_search","company_verification","vat_discovery"]},"environment":{"$ref":"#/components/schemas/VerificationEnvironment"},"authorityScope":{"type":["string","null"],"minLength":1,"maxLength":240},"attemptedAt":{"type":["string","null"],"format":"date-time"},"observedAt":{"type":["string","null"],"format":"date-time"},"retrievedAt":{"type":"string","format":"date-time"},"servedAt":{"type":"string","format":"date-time"},"sourceRecordUpdatedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetPublishedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetImportedAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"datasetEffectiveAt":{"$ref":"#/components/schemas/NullableSourceTemporalValue"},"deliveryForm":{"type":"string","enum":["live_source_call","official_snapshot","cached_observation","coalesced_observation","sandbox_fixture"]},"rightsReference":{"type":["string","null"],"format":"uri"},"rightsPolicyVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"parserVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"coveragePolicyVersion":{"type":["string","null"],"minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"nativeStatus":{"type":["string","null"],"maxLength":500},"nativeValue":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"completion":{"$ref":"#/components/schemas/EvidenceCompletion"},"warnings":{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"maxItems":64},"suppression":{"type":"object","properties":{"suppressed":{"type":"boolean"},"reason":{"type":["string","null"],"minLength":1,"maxLength":500},"effectiveAt":{"type":["string","null"],"format":"date-time"}},"required":["suppressed","reason","effectiveAt"],"additionalProperties":false},"contentDigest":{"type":["string","null"],"pattern":"^sha256:[a-f0-9]{64}$"},"proofReference":{"type":["string","null"],"minLength":1,"maxLength":500},"metadataCompleteness":{"type":"string","enum":["complete","legacy_partial"]}},"required":["id","source","sourceRecordId","subject","capability","environment","authorityScope","attemptedAt","observedAt","retrievedAt","servedAt","sourceRecordUpdatedAt","datasetPublishedAt","datasetImportedAt","datasetEffectiveAt","deliveryForm","rightsReference","rightsPolicyVersion","parserVersion","coveragePolicyVersion","nativeStatus","nativeValue","completion","warnings","suppression","contentDigest","proofReference","metadataCompleteness"],"additionalProperties":false},"maxItems":500},"freshness":{"$ref":"#/components/schemas/VerificationFreshness"},"usage":{"$ref":"#/components/schemas/VerificationUsageSettlement"}},"required":["schemaVersion","operation","subject","result","claims","relationships","conflicts","issues","evidence","staleEvidence","freshness","usage"],"additionalProperties":false},"CompanyVerificationResultV2":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["company_verification"]},"outcome":{"type":"string","enum":["found"]},"company":{"$ref":"#/components/schemas/VerifiedCompanyProfileV2"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100}},"required":["kind","outcome","company","evidenceRefs"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["company_verification"]},"outcome":{"type":"string","enum":["conflicting"]},"company":{"$ref":"#/components/schemas/VerifiedCompanyProfileV2"},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":2,"maxItems":100}},"required":["kind","outcome","company","evidenceRefs"],"additionalProperties":false},{"$ref":"#/components/schemas/NotFoundCompanyVerificationResult"},{"$ref":"#/components/schemas/UnsupportedCompanyVerificationResult"},{"$ref":"#/components/schemas/UnavailableCompanyVerificationResult"}]},"VerifiedCompanyProfileV2":{"type":"object","properties":{"entity":{"$ref":"#/components/schemas/LegalEntityIdentity"},"legalName":{"type":["string","null"],"maxLength":500},"registeredAddress":{"type":"object","properties":{"fullAddress":{"type":["string","null"],"maxLength":1000},"postalCode":{"type":["string","null"],"maxLength":80},"locality":{"type":["string","null"],"maxLength":240},"countryCode":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"countryLabel":{"type":["string","null"],"maxLength":240}},"required":["fullAddress","postalCode","locality","countryCode","countryLabel"],"additionalProperties":false},"status":{"type":"string","enum":["active","ceased","unknown"]},"rawStatus":{"type":["string","null"],"maxLength":500},"statusMeaning":{"type":"string","minLength":1,"maxLength":1000},"legalFormCode":{"type":["string","null"],"maxLength":160},"disclosure":{"type":"string","enum":["public","partial","unknown"]},"nationalVatRegistration":{"type":["object","null"],"properties":{"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"status":{"type":"string","enum":["registered","not_registered","unknown"]},"registrationDate":{"type":["string","null"],"maxLength":500},"deregistrationDate":{"type":["string","null"],"maxLength":500},"rawStatus":{"type":["string","null"],"maxLength":500},"meaning":{"type":"string","minLength":1,"maxLength":1000}},"required":["jurisdiction","status","registrationDate","deregistrationDate","rawStatus","meaning"],"additionalProperties":false},"evidenceRefs":{"type":"array","items":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"minItems":1,"maxItems":100},"facts":{"$ref":"#/components/schemas/CompanyFactsV1"}},"required":["entity","legalName","registeredAddress","status","rawStatus","statusMeaning","legalFormCode","disclosure","evidenceRefs"],"additionalProperties":false},"CompanyResourceEnvelopeV2":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CompanyDataV2"},"provenance":{"$ref":"#/components/schemas/ResourceProvenanceV2"},"usage":{"$ref":"#/components/schemas/ResourceUsageV2"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["data","usage"]},"CompanyDataV2":{"type":"object","properties":{"id":{"type":"string","minLength":1},"legal_name":{"type":"string","minLength":1},"brand_name":{"type":["string","null"]},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"company_id":{"type":["string","null"]},"tax_id":{"type":["string","null"]},"lei":{"type":["string","null"]},"vat":{"$ref":"#/components/schemas/CompanyVatProfileV2"},"legal_entity":{"$ref":"#/components/schemas/ResourceLegalEntityV2"},"address":{"$ref":"#/components/schemas/ResourceAddressV2"},"facts":{"$ref":"#/components/schemas/CompanyFactsV1"},"identity_state":{"type":"string"},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/CompanyIdentifierV2"}},"field_provenance":{"type":"array","items":{"$ref":"#/components/schemas/CompanyFieldProvenanceV2"}},"completeness":{"type":"string","enum":["partial","complete"]},"missing_fields":{"type":"array","items":{"$ref":"#/components/schemas/CompanyMissingFieldV2"}}},"required":["id","legal_name","jurisdiction"]},"CompanyVatProfileV2":{"type":["object","null"],"properties":{"id":{"type":"string","minLength":1},"status":{"oneOf":[{"type":"string","enum":["valid","invalid","unavailable","unknown"]},{"type":"string"}]},"authority":{"type":"string","minLength":1},"checked_at":{"type":["string","null"],"minLength":1}},"required":["id","status","authority","checked_at"]},"ResourceLegalEntityV2":{"type":["object","null"],"properties":{"native_value":{"type":["string","null"]},"acronym":{"type":["string","null"]},"native_name":{"type":["string","null"]},"english_name":{"type":["string","null"]},"category":{"$ref":"#/components/schemas/LegalEntityCategoryCode"},"iso_elf_code":{"type":["string","null"]},"common_analogue":{"type":["string","null"]},"description":{"type":["string","null"]}}},"ResourceAddressV2":{"type":["object","null"],"properties":{"raw":{"type":["string","null"]},"formatted":{"type":["string","null"]},"country":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"locality":{"type":["string","null"]},"region":{"type":["string","null"]},"subdivision_code":{"type":["string","null"]},"iso_subdivision":{"type":["string","null"]},"street":{"type":["string","null"]},"street_line1":{"type":["string","null"]},"street_line2":{"type":["string","null"]},"components":{"$ref":"#/components/schemas/AddressComponentsV1"},"metadata":{"$ref":"#/components/schemas/AddressMetadataV1"}}},"CompanyIdentifierV2":{"type":"object","properties":{"type":{"type":"string","enum":["registry_id","domestic_tax_id","vat_id","lei"]},"value":{"type":"string","minLength":1},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"issuer":{"type":["string","null"]},"register":{"type":["string","null"]},"evidence_refs":{"type":"array","items":{"type":"string"}},"state":{"type":"string"},"basis":{"type":"string"}},"required":["type","value","jurisdiction","issuer","register","evidence_refs"]},"CompanyFieldProvenanceV2":{"type":"object","properties":{"field":{"type":"string"},"state":{"type":"string"},"observed_at":{"type":["string","null"]},"evidence_refs":{"type":"array","items":{"type":"string"}}},"required":["field","state","observed_at","evidence_refs"]},"CompanyMissingFieldV2":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"]},"ResourceProvenanceV2":{"type":"object","properties":{"confidence":{"oneOf":[{"type":"string","enum":["high","medium","low","uncertain"]},{"type":"string"}]},"sources_consulted":{"type":"array","items":{"type":"string"},"default":[]},"matched_domains":{"type":"array","items":{"type":"string"}},"evidence_count":{"type":"integer","minimum":0},"retrieved_at":{"type":"string"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/CompanySourceProvenanceV2"}}}},"CompanySourceProvenanceV2":{"type":"object","properties":{"id":{"type":"string"},"evidence_id":{"type":"string"},"independence_key":{"type":"string","minLength":1,"maxLength":160},"source_record_id":{"type":["string","null"]},"rights_policy_version":{"type":["string","null"]},"parser_version":{"type":["string","null"],"minLength":1},"coverage_policy_version":{"type":["string","null"],"minLength":1},"url":{"type":"string","format":"uri"},"classification":{"type":["string","null"]},"authority_scope":{"type":["string","null"]},"population_scope":{"type":["string","null"]},"field_scope":{"type":["string","null"]},"observed_at":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_record_updated_at":{"type":["string","null"]},"source_record_updated_at_raw":{"type":["string","null"]},"dataset_published_at":{"type":["string","null"]},"dataset_imported_at":{"type":["string","null"]},"delivery_form":{"type":"string"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["id","url","classification","authority_scope","population_scope","field_scope","observed_at","retrieved_at","source_record_updated_at","dataset_published_at","dataset_imported_at","delivery_form","warnings"]},"ResourceUsageV2":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0},"operation_id":{"type":"string"},"meter":{"type":"string"}},"required":["units_charged"]},"CompanyResolutionMetadataV2":{"type":"object","properties":{"outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unsupported"]},"identity_confirmed":{"type":"boolean"},"total_results":{"type":["integer","null"],"minimum":0},"truncated":{"type":"boolean"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/CompanySourceProvenanceV2"}},"enrichment_outcome":{"type":"string","enum":["found","ambiguous","partial","conflicting","not_found","source_unavailable","unsupported"]},"reason":{"type":"string"},"discovery_leads":{"type":"array","items":{"$ref":"#/components/schemas/CanonicalCompanyDiscoveryLeadV2"}}},"required":["outcome","identity_confirmed","total_results","truncated","sources"]},"CanonicalCompanyDiscoveryLeadV2":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":160,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"label":{"type":"string","minLength":1,"maxLength":500},"resolutionState":{"type":"string","enum":["discovered"]},"unverifiedEntityHint":{"oneOf":[{"$ref":"#/components/schemas/LegalEntityIdentity"},{"type":"null"}]},"discoveryRefs":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionDiscoveryReferenceV2"},"minItems":1,"maxItems":100},"source_urls":{"type":"array","items":{"type":"string","format":"uri"}},"discovered_at":{"type":["string","null"]}},"required":["id","jurisdiction","label","resolutionState","unverifiedEntityHint","discoveryRefs","source_urls","discovered_at"],"additionalProperties":false},"CompactCompanyResourceEnvelopeV2":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CompactCompanyDataV2"},"provenance":{"$ref":"#/components/schemas/ResourceProvenanceV2"},"usage":{"$ref":"#/components/schemas/ResourceUsageV2"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["data","usage"]},"CompactCompanyDataV2":{"type":"object","properties":{"id":{"type":"string","minLength":1},"legal_name":{"type":"string","minLength":1},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"company_id":{"type":["string","null"]},"vat_id":{"type":["string","null"]},"vat_status":{"type":["string","null"]},"legal_entity":{"$ref":"#/components/schemas/CompactLegalEntityV2"},"facts":{"$ref":"#/components/schemas/CompanyFactsV1"},"identity_state":{"type":"string"},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/CompanyIdentifierV2"}},"field_provenance":{"type":"array","items":{"$ref":"#/components/schemas/CompanyFieldProvenanceV2"}},"completeness":{"type":"string","enum":["partial","complete"]},"missing_fields":{"type":"array","items":{"$ref":"#/components/schemas/CompanyMissingFieldV2"}}},"required":["id","legal_name","jurisdiction"]},"CompactLegalEntityV2":{"type":["object","null"],"properties":{"native_value":{"type":["string","null"]},"acronym":{"type":["string","null"]},"category":{"$ref":"#/components/schemas/LegalEntityCategoryCode"},"iso_elf_code":{"type":["string","null"]}}},"CompanySearchCollectionV1":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CompanySearchItemV1"},"description":"Matched company candidates"},"total_results":{"type":["integer","null"],"minimum":0,"description":"Total number of candidate matches, or null when the source did not establish a total"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["items","total_results"]},"CompanySearchItemV1":{"type":"object","properties":{"id":{"type":"string","description":"Unique company identifier"},"legal_name":{"type":["string","null"],"description":"Official registered legal name, or null when not disclosed by the source"},"brand_name":{"type":["string","null"],"description":"Known commercial or brand name"},"country_code":{"type":"string","description":"ISO 3166-1 alpha-2 country code"},"company_id":{"type":["string","null"],"description":"National registry identification number"},"tax_id":{"type":["string","null"],"description":"National tax identification number"},"status":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/CompanyStatusV1"},{"type":"null"}],"description":"Company operational standing from commercial register"},"vat":{"$ref":"#/components/schemas/CompanyVatProfileV1"},"address":{"$ref":"#/components/schemas/CanonicalAddressV1"},"legal_entity":{"$ref":"#/components/schemas/LegalEntityClassificationV1"},"facts":{"$ref":"#/components/schemas/CompanyFactsV1"},"identity_state":{"type":"string"},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/CompanyIdentifierV2"}},"field_provenance":{"type":"array","items":{"$ref":"#/components/schemas/CompanyFieldProvenanceV2"}},"completeness":{"type":"string","enum":["partial","complete"]},"missing_fields":{"type":"array","items":{"$ref":"#/components/schemas/CompanyMissingFieldV2"}}},"required":["id","legal_name","country_code"]},"CompanyStatusV1":{"type":"object","properties":{"standing":{"type":"string","enum":["active","dissolved","in_liquidation","bankrupt","inactive","unsupported"],"description":"Observed administrative business-register status. Inactive does not by itself establish legal dissolution or insolvency."},"verified_against_registry":{"type":"boolean","description":"True if a live official business-register observation supplied a known administrative status; false if unverified or synthetic."},"source_tier":{"type":"string","enum":["primary_commercial_registry","official_business_register","corroborated_official_gazette","unsupported"],"description":"Classification of registry corroboration source"},"registry_name":{"type":["string","null"],"description":"Name of the national corporate register or null"},"registry_identifier":{"type":["string","null"],"description":"Official registration number in the corporate registry or null"},"notes":{"type":["string","null"],"description":"Disclaimers or details (e.g. 'Commercial register check unavailable for this jurisdiction. 0 quota charged.')"}},"required":["standing","verified_against_registry","source_tier","registry_name","registry_identifier","notes"]},"CompanyVatProfileV1":{"type":["object","null"],"properties":{"vat_id":{"type":"string","description":"Standardized VAT identifier"},"status":{"type":"string","enum":["valid","invalid","unconfirmed"],"description":"Verification status from VIES / HMRC"},"authority":{"type":"string","description":"Tax authority verifying this VAT (e.g. 'eu_vies', 'uk_hmrc')"},"checked_at":{"type":["string","null"],"description":"Authority validation time; null when no validation completed"},"resolution_method":{"type":"string","enum":["official_registry","calculated_algorithm_verified","derived_candidate","web_corroborated","source_attributed"],"description":"Method through which this VAT was discovered and verified"}},"required":["vat_id","status","authority","resolution_method"]},"CanonicalAddressV1":{"type":["object","null"],"properties":{"raw":{"type":["string","null"],"description":"Verbatim address string returned by registry or authority"},"formatted":{"type":["string","null"],"description":"Single-line formatted address"},"country":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 country code"},"postal_code":{"type":["string","null"],"description":"Postal or ZIP code"},"locality":{"type":["string","null"],"description":"City or municipality"},"region":{"type":["string","null"],"description":"Administrative region or state"},"subdivision_code":{"type":["string","null"],"description":"Short national subdivision code (e.g. province)"},"iso_subdivision":{"type":["string","null"],"description":"ISO 3166-2 subdivision code"},"street":{"type":["string","null"],"description":"Combined thoroughfare and number"},"street_line1":{"type":["string","null"],"description":"Primary street address line"},"street_line2":{"type":["string","null"],"description":"Secondary street address line (suite, unit, floor)"},"components":{"type":["object","null"],"properties":{"street_category":{"type":["string","null"],"enum":["street","avenue","boulevard","square","road","lane","way","walk","drive","alley","court","place","quay","crescent","roundabout","passage","industrial_zone","path","other",null],"description":"Canonical thoroughfare classification constant in English (e.g. 'street', 'avenue', 'square', 'road').","example":"street"},"street_type":{"type":["string","null"],"description":"Localized thoroughfare word in the jurisdiction's official language (e.g. 'Calle', 'Via', 'Rue', 'Straße', 'Ulica', 'Gata').","example":"Calle"},"street_type_english":{"type":["string","null"],"description":"English translation / generic meaning of the localized street type (e.g. 'Street', 'Avenue', 'Square').","example":"Street"},"street_type_abbreviations":{"type":["array","null"],"items":{"type":"string"},"description":"Known official abbreviations, acronyms, and preposition/article variants for the street type in this country.","example":["C/","C.","C","C de","C/ de"]},"street_name":{"type":["string","null"],"description":"Primary thoroughfare name excluding type prefix and house number.","example":"Marghera"},"house_number":{"type":["string","null"],"description":"Primary building or house number.","example":"2"},"house_number_addition":{"type":["string","null"],"description":"House number suffix, letter, or modifier (e.g. 'B', 'bis', 'ter', 'Apt 2').","example":null},"unit":{"type":["string","null"],"description":"Secondary unit, staircase, floor, door, or suite identifier.","example":"int. 4"},"district":{"type":["string","null"],"description":"Sub-locality, neighborhood, borough, or dependent locality.","example":"Esquilino"}},"additionalProperties":{}}},"additionalProperties":{}},"LegalEntityClassificationV1":{"type":["object","null"],"properties":{"native_value":{"type":["string","null"],"description":"Verbatim legal form published by the company source; may be a native code or label"},"acronym":{"type":["string","null"],"description":"Corporate legal form acronym (e.g. 'SL', 'GmbH', 'SARL')"},"native_name":{"type":["string","null"],"description":"Legal form in official national language"},"english_name":{"type":["string","null"],"description":"English translation of legal form"},"category":{"oneOf":[{"$ref":"#/components/schemas/LegalEntityCategoryCode"},{"type":"string"},{"type":"null"}],"description":"Entity classification category code"},"iso_elf_code":{"type":["string","null"],"description":"ISO 20275 Entity Legal Form 4-alphanumeric code"},"common_analogue":{"type":["string","null"],"description":"Common international analogue (e.g. 'LLC')"},"description":{"type":["string","null"],"description":"Descriptive summary of entity legal characteristics"}},"additionalProperties":{}},"ProblemInvalidParam":{"type":"object","properties":{"name":{"type":"string","minLength":1},"reason":{"type":"string","minLength":1}},"required":["name","reason"]},"AgentGuidance":{"type":"object","properties":{"hint":{"type":"string","minLength":1},"suggested_actions":{"type":"array","items":{"$ref":"#/components/schemas/AgentAction"},"default":[]}},"required":["hint"]},"AgentAction":{"type":"object","properties":{"method":{"oneOf":[{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},{"type":"string"}]},"endpoint":{"type":"string","minLength":1},"params":{"type":"object","additionalProperties":{}}},"required":["method","endpoint"]},"VatResourceEnvelopeV2":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/VatDataV2"},"provenance":{"$ref":"#/components/schemas/ResourceProvenanceV2"},"usage":{"$ref":"#/components/schemas/ResourceUsageV2"}},"required":["data","usage"]},"VatDataV2":{"type":"object","properties":{"vat_id":{"type":"string","minLength":1},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"outcome":{"oneOf":[{"type":"string","enum":["valid","invalid","unavailable","unknown"]},{"type":"string"}]},"legal_name":{"type":["string","null"]},"address":{"$ref":"#/components/schemas/ResourceAddressV2"},"legal_entity":{"$ref":"#/components/schemas/ResourceLegalEntityV2"}},"required":["vat_id","jurisdiction","outcome"]},"CompactVatResourceEnvelopeV2":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CompactVatDataV2"},"provenance":{"$ref":"#/components/schemas/ResourceProvenanceV2"},"usage":{"$ref":"#/components/schemas/ResourceUsageV2"}},"required":["data","usage"]},"CompactVatDataV2":{"type":"object","properties":{"vat_id":{"type":"string","minLength":1},"jurisdiction":{"type":"string","pattern":"^[A-Z]{2}$"},"outcome":{"oneOf":[{"type":"string","enum":["valid","invalid","unavailable","unknown"]},{"type":"string"}]},"legal_name":{"type":["string","null"]},"legal_entity":{"$ref":"#/components/schemas/CompactLegalEntityV2"}},"required":["vat_id","jurisdiction","outcome"]},"ProblemDetailsV2":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"}},"required":["type","title","status"]},"LegalFormDefinition":{"type":"object","properties":{"id":{"type":"string","minLength":1},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"isoElfCode":{"type":["string","null"],"pattern":"^[A-Z0-9]{4}$"},"canonicalAcronym":{"type":"string","minLength":1},"nativeName":{"type":"string","minLength":1},"englishName":{"type":"string","minLength":1},"category":{"$ref":"#/components/schemas/LegalEntityCategoryCode"},"briefDescription":{"type":"string","minLength":1},"detailedDescription":{"type":"string","minLength":1},"acronymVariants":{"type":"array","items":{"type":"string","minLength":1}},"regexPatterns":{"type":"array","items":{"type":"string","minLength":1}},"minimumCapital":{"type":["string","null"]},"liabilityModel":{"type":"string","enum":["limited","unlimited","hybrid","none"]},"regionalNotes":{"type":["string","null"]},"statutorySource":{"type":"string","minLength":1}},"required":["id","country","isoElfCode","canonicalAcronym","nativeName","englishName","category","briefDescription","detailedDescription","acronymVariants","regexPatterns","minimumCapital","liabilityModel","regionalNotes","statutorySource"],"additionalProperties":false},"JurisdictionReference":{"type":"object","properties":{"code":{"type":"string","minLength":2,"maxLength":2},"label":{"type":"string","minLength":1},"vat_prefix":{"type":"string","minLength":2,"maxLength":2},"authority":{"type":"string","minLength":1},"eu_member":{"type":"boolean"},"capabilities":{"type":"array","items":{"type":"string"}}},"required":["code","label","vat_prefix","authority","eu_member","capabilities"]},"VatVerifyEnvelopeV1":{"type":"object","properties":{"status":{"oneOf":[{"type":"string","enum":["valid","invalid","unavailable","unknown"]},{"type":"string"}],"description":"Verification outcome status ('valid', 'invalid', etc.)"},"vat_id":{"type":"string","description":"Normalized VAT identifier"},"country_code":{"type":"string","description":"ISO 3166-1 alpha-2 country code"},"company":{"$ref":"#/components/schemas/VatVerifyCompanyV1"},"consultation":{"$ref":"#/components/schemas/VatConsultationV1"},"components":{"$ref":"#/components/schemas/CanonicalStandingComponentsV1"},"quota":{"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 and HMRC"},"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"],"description":"Fine-grained usage and remaining allowance for the current billing cycle"}},"required":["status","vat_id","country_code","quota"]},"VatVerifyCompanyV1":{"type":["object","null"],"properties":{"legal_name":{"type":["string","null"],"description":"Registered corporate legal name"},"status":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/CompanyStatusV1"},{"type":"null"}],"description":"Company operational standing (e.g. 'active', 'dissolved')"},"address":{"$ref":"#/components/schemas/CanonicalAddressV1"},"legal_entity":{"$ref":"#/components/schemas/LegalEntityClassificationV1"}}},"VatConsultationV1":{"type":["object","null"],"properties":{"official_consultation_number":{"type":["string","null"],"description":"Authority-issued request identifier from a live qualified consultation, or null when none was returned. Sandbox and platform identifiers are never official receipts."},"internal_receipt_id":{"type":"string","description":"Durable tracking UUID issued by vat-tools platform"},"verified_at":{"type":"string","description":"ISO-8601 UTC timestamp of registry observation"},"authority":{"type":"string","enum":["eu_vies","uk_hmrc","synthetic_sandbox","national_registry"]},"is_audit_admissible":{"type":"boolean","description":"Deprecated legal assertion; new responses return false. This API cannot determine evidentiary admissibility or entitlement to VAT exemption."},"has_official_receipt":{"type":"boolean","description":"True when this response preserves an authority-issued live consultation identifier. This is not a guarantee of admissibility, identity disclosure, or VAT exemption."}},"required":["official_consultation_number","internal_receipt_id","verified_at","authority","is_audit_admissible"]},"CanonicalStandingComponentsV1":{"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":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"startsAt":{"type":"string","format":"date-time"},"endsAt":{"type":"string","format":"date-time"}},"required":["id","startsAt","endsAt"],"additionalProperties":false},"policy_version":{"type":"string","minLength":1},"status":{"type":"string","enum":["completed"]},"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"]},"kind":{"type":"string","enum":["vat_validation"]}},"required":["operation_id","period","policy_version","status","units_charged","settlement_reason","kind"],"additionalProperties":false},"standing":{"type":["object","null"],"properties":{"operation_id":{"type":"string","format":"uuid"},"period":{"type":"object","properties":{"id":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"startsAt":{"type":"string","format":"date-time"},"endsAt":{"type":"string","format":"date-time"}},"required":["id","startsAt","endsAt"],"additionalProperties":false},"policy_version":{"type":"string","minLength":1},"status":{"type":"string","enum":["completed","failed","interrupted"]},"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"]},"kind":{"type":"string","enum":["company_verification"]}},"required":["operation_id","period","policy_version","status","units_charged","settlement_reason","kind"],"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. 'DE129274202') submitted to VIES for a qualified consultation. Receipt and identity disclosure depend on the authority response; withheld details remain undisclosed."},"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'"}},"required":["vat_id"]},"CompanySearchEnvelopeV1":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CompanySearchItemV1"},"description":"Matched company candidates"},"total_results":{"type":["integer","null"],"minimum":0,"description":"Total number of candidate matches, or null when the source did not establish a total"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"},"quota":{"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 and HMRC"},"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"],"description":"Fine-grained usage and remaining allowance for the current billing cycle"}},"required":["items","total_results","quota"]},"CompanySearchInputV1":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":256,"description":"Company, brand, or trade name to search for"},"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"},"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","default":true,"description":"If true, performs automated reverse VAT discovery for candidate entities"},"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'"}}},"VatCalculateEnvelopeV1":{"type":"object","properties":{"jurisdiction":{"$ref":"#/components/schemas/VatJurisdictionResolutionV1"},"rates":{"$ref":"#/components/schemas/VatRatesBreakdownV1"},"calculation":{"$ref":"#/components/schemas/VatCalculationSummaryV1"},"quota":{"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 and HMRC"},"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"],"description":"Fine-grained usage and remaining allowance for the current billing cycle"}},"required":["jurisdiction","rates","quota"]},"VatJurisdictionResolutionV1":{"type":"object","properties":{"country_code":{"type":"string","description":"ISO 3166-1 alpha-2 country code"},"country_name":{"type":"string","description":"English name of the jurisdiction"},"currency":{"type":"string","description":"Default currency code for the jurisdiction"},"detection_source":{"type":"string","description":"Detection mechanism: 'country_code', 'domain', 'client_ip', or 'default'"}},"required":["country_code"]},"VatRatesBreakdownV1":{"type":"object","properties":{"standard":{"type":["number","null"],"description":"Standard VAT rate"},"reduced":{"oneOf":[{"type":"number"},{"type":"array","items":{"type":"number"}},{"type":"null"}],"description":"Reduced VAT rate(s)"},"super_reduced":{"type":["number","null"],"description":"Super-reduced VAT rate"},"parking":{"type":["number","null"],"description":"Parking VAT rate"},"zero":{"type":["number","null"],"description":"Zero VAT rate"}},"additionalProperties":{}},"VatCalculationSummaryV1":{"type":["object","null"],"properties":{"subtotal":{"type":"number","description":"Total net taxable amount"},"total_tax":{"type":"number","description":"Total tax amount"},"total_amount":{"type":"number","description":"Total gross amount"},"items":{"type":"array","items":{"$ref":"#/components/schemas/VatCalculatedItemV1"},"description":"Itemized line calculations"}},"required":["subtotal","total_tax","total_amount","items"]},"VatCalculatedItemV1":{"type":"object","properties":{"id":{"type":"string","description":"Item identifier"},"description":{"type":"string","description":"Product or service description"},"tier":{"type":"string","description":"Applied rate tier ('standard', 'reduced', 'zero', etc.)"},"applied_rate":{"type":"number","description":"Percentage rate applied"},"tax_amount":{"type":"number","description":"Calculated tax amount"},"gross_amount":{"type":"number","description":"Total amount inclusive of tax"},"classification_reason":{"type":"string","description":"Reason for rate tier selection"}},"required":["description","applied_rate","tax_amount","gross_amount"]},"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"]}},"parameters":{}},"paths":{"/api/v2/validations":{"post":{"operationId":"createPublicVatValidation","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":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVatValidationInput"}}}},"responses":{"200":{"description":"Saved VAT validation projected into the canonical public envelope","headers":{"Idempotency-Key":{"description":"Key to reuse with this same normalized request.","schema":{"type":"string"}},"X-Operation-Id":{"description":"The saved run ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered an existing saved result.","schema":{"type":"string","enum":["true","false"]}},"X-Usage-Charged":{"description":"Additional units for this HTTP response; always zero for a replay.","schema":{"type":"string","enum":["0","1"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVatValidationEnvelope"}}}},"400":{"description":"Invalid request, freshness policy or source capability","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, scope or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"409":{"description":"Idempotency conflict, unfinished or interrupted operation","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"410":{"description":"The saved result expired or was source-suppressed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"415":{"description":"JSON content type required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Request rate or monthly allowance exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"No successful save could be confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/api/v2/company-searches":{"post":{"operationId":"createPublicCompanySearch","summary":"Search a certified company source","description":"Returns sourced candidates with registry-qualified identities and an explicit resolution boundary.","security":[{"DeveloperKey":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanySearchInput"}}}},"responses":{"200":{"description":"Saved company search projected into the canonical public envelope","headers":{"Idempotency-Key":{"description":"Key to reuse with this same normalized request.","schema":{"type":"string"}},"X-Operation-Id":{"description":"The saved run ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered an existing saved result.","schema":{"type":"string","enum":["true","false"]}},"X-Usage-Charged":{"description":"Additional units for this HTTP response; always zero for a replay.","schema":{"type":"string","enum":["0","1"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanySearchEnvelope"}}}},"400":{"description":"Invalid request, freshness policy or source capability","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, scope or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"409":{"description":"Idempotency conflict, unfinished or interrupted operation","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"410":{"description":"The saved result expired or was source-suppressed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"415":{"description":"JSON content type required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Request rate or monthly allowance exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"No successful save could be confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/api/v2/company-resolutions":{"post":{"operationId":"createPublicCompanyResolution","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.","security":[{"DeveloperKey":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyResolutionInputV2"}}}},"responses":{"200":{"description":"Saved company resolution with field evidence, source trail and VAT validation","headers":{"Idempotency-Key":{"description":"Key to reuse with this same normalized request.","schema":{"type":"string"}},"X-Operation-Id":{"description":"The saved run ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered an existing saved result.","schema":{"type":"string","enum":["true","false"]}},"X-Usage-Charged":{"description":"Additional units for this HTTP response; always zero for a replay.","schema":{"type":"string","enum":["0","1"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyResolutionEnvelopeV2"}}}},"400":{"description":"Invalid request, freshness policy or source capability","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, scope or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"409":{"description":"Idempotency conflict, unfinished or interrupted operation","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"410":{"description":"The saved result expired or was source-suppressed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"415":{"description":"JSON content type required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Request rate or monthly allowance exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"No successful save could be confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/api/v2/company-web-searches":{"post":{"operationId":"createPublicCompanyWebSearch","summary":"Search the open web and reconcile company data across jurisdictions","description":"Discovers company information, addresses, tax IDs, LEIs and VAT registrations via multi-provider web search and deterministic data reconciliation.","security":[{"DeveloperKey":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyWebSearchInputV2"}}}},"responses":{"200":{"description":"Saved company web search with reconciled company profile, candidate matches and source reconciliation basis","headers":{"Idempotency-Key":{"description":"Key to reuse with this same normalized request.","schema":{"type":"string"}},"X-Operation-Id":{"description":"The saved run ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered an existing saved result.","schema":{"type":"string","enum":["true","false"]}},"X-Usage-Charged":{"description":"Additional units for this HTTP response; always zero for a replay.","schema":{"type":"string","enum":["0","1"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyWebSearchEnvelopeV2"}}}},"400":{"description":"Invalid request, freshness policy or source capability","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, scope or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"409":{"description":"Idempotency conflict, unfinished or interrupted operation","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"410":{"description":"The saved result expired or was source-suppressed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"415":{"description":"JSON content type required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Request rate or monthly allowance exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"No successful save could be confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/api/v2/company-verifications":{"post":{"operationId":"createPublicCompanyVerification","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":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyVerificationInput"}}}},"responses":{"200":{"description":"Saved company verification projected into the canonical public envelope","headers":{"Idempotency-Key":{"description":"Key to reuse with this same normalized request.","schema":{"type":"string"}},"X-Operation-Id":{"description":"The saved run ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered an existing saved result.","schema":{"type":"string","enum":["true","false"]}},"X-Usage-Charged":{"description":"Additional units for this HTTP response; always zero for a replay.","schema":{"type":"string","enum":["0","1"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyVerificationEnvelope"}}}},"400":{"description":"Invalid request, freshness policy or source capability","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, scope or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"409":{"description":"Idempotency conflict, unfinished or interrupted operation","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"410":{"description":"The saved result expired or was source-suppressed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"415":{"description":"JSON content type required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Request rate or monthly allowance exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"No successful save could be confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/api/v2/company-vat-discoveries":{"post":{"operationId":"createPublicCompanyVatDiscovery","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":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyVatDiscoveryInput"}}}},"responses":{"200":{"description":"Saved VAT discovery projected into the canonical public envelope","headers":{"Idempotency-Key":{"description":"Key to reuse with this same normalized request.","schema":{"type":"string"}},"X-Operation-Id":{"description":"The saved run ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered an existing saved result.","schema":{"type":"string","enum":["true","false"]}},"X-Usage-Charged":{"description":"Additional units for this HTTP response; always zero for a replay.","schema":{"type":"string","enum":["0","1"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVatDiscoveryEnvelope"}}}},"400":{"description":"Invalid request, freshness policy or source capability","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, scope or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"409":{"description":"Idempotency conflict, unfinished or interrupted operation","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"410":{"description":"The saved result expired or was source-suppressed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"415":{"description":"JSON content type required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Request rate or monthly allowance exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"No successful save could be confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/api/v2/company-searches/{searchOperationId}/selection":{"post":{"operationId":"selectPublicCompanySearchCandidate","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":[]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"searchOperationId","in":"path"},{"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"}}}},"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"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchCandidateSelectionResponseV1"}}}},"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"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchCandidateSelectionResponseV1"}}}},"400":{"description":"Invalid operation ID, idempotency key or strict request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, permission or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"404":{"description":"Completed company search or selected candidate not found in this scope","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"409":{"description":"Idempotency conflict or this search already has a selection","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"410":{"description":"The company-search result expired or was source-suppressed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"415":{"description":"JSON content type required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"The company search or selection could not be confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/api/v2/verifications":{"get":{"operationId":"listPublicVerificationsV1","summary":"List canonical verification responses","description":"Returns immutable saved responses in stable newest-first order for one organization environment. Defaults to V1; explicit V2 admits only exact company verification under current retained-review policy. Evidence servedAt is refreshed for delivery. Unavailable retained V2 records are omitted; legacy runs are never reconstructed.","security":[{"DeveloperKey":[]},{"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 exact company-verification V2 history page","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicVerificationHistoryPageV1"},{"$ref":"#/components/schemas/PublicCompanyVerificationHistoryPageV2"}]}}}},"400":{"description":"Invalid query or cursor","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, scope or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"History or a durable response snapshot is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/api/v2/verifications/{operationId}":{"get":{"operationId":"getPublicVerificationV1","summary":"Get one canonical verification response","description":"Returns the original immutable saved response within the authenticated organization environment. Defaults to V1; explicit V2 admits only exact company verification under current retained-review policy. Evidence servedAt is refreshed for delivery.","security":[{"DeveloperKey":[]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"operationId","in":"path"},{"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":"Original V1 or exact company-verification V2 snapshot","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicVatValidationEnvelope"},{"$ref":"#/components/schemas/PublicCompanySearchEnvelope"},{"$ref":"#/components/schemas/PublicCompanyVerificationEnvelope"},{"$ref":"#/components/schemas/PublicVatDiscoveryEnvelope"},{"$ref":"#/components/schemas/PublicCompanyVerificationEnvelopeV2"}]}}}},"400":{"description":"Invalid operation identifier or environment","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, scope or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"404":{"description":"No completed verification exists in this organization environment","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"410":{"description":"The saved result expired or was source-suppressed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"History or the durable response snapshot is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/v1/companies":{"get":{"operationId":"getCompaniesV1","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":[]},{"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/CompanyResourceEnvelopeV2"},{"$ref":"#/components/schemas/CompactCompanyResourceEnvelopeV2"},{"$ref":"#/components/schemas/CompanySearchCollectionV1"}]}},"application/ld+json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"description":"Invalid parameters","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}},"401":{"description":"Missing or invalid authentication"},"403":{"description":"Scope, organization or environment access denied"},"404":{"description":"No match in the consulted source scope","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}},"406":{"description":"A selected exact company is required for JSON-LD","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}},"422":{"description":"Unsupported jurisdiction/register scope or insufficient exact company profile/identity","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}},"429":{"description":"The durable operation allowance is exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"Certified source or runtime unavailable","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}}}}},"/v1/companies/{jurisdiction}/{id}":{"get":{"operationId":"getCompanyByIdV1","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":[]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"jurisdiction","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"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"}],"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/CompanyResourceEnvelopeV2"},{"$ref":"#/components/schemas/CompactCompanyResourceEnvelopeV2"},{"$ref":"#/components/schemas/CompanySearchCollectionV1"}]}},"application/ld+json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"description":"Invalid parameters","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}},"401":{"description":"Missing or invalid authentication"},"403":{"description":"Scope, organization or environment access denied"},"404":{"description":"No match in the consulted source scope","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}},"406":{"description":"A selected exact company is required for JSON-LD","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}},"422":{"description":"Unsupported jurisdiction/register scope or insufficient exact company profile/identity","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}},"429":{"description":"The durable operation allowance is exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"Certified source or runtime unavailable","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":100,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/ProblemInvalidParam"}},"agent_guidance":{"$ref":"#/components/schemas/AgentGuidance"},"resolution":{"$ref":"#/components/schemas/CompanyResolutionMetadataV2"}},"required":["type","title","status"]}}}}}}},"/v1/vat-numbers/{countryCode}/{vatNumber}":{"get":{"operationId":"getVatNumberV1","summary":"Instant VAT & Entity Check","description":"Fast, safe, cached check against official authorities (EU VIES, HMRC) with instant legal entity classification.","security":[{"DeveloperKey":[]},{"AccountSession":[]}],"parameters":[{"schema":{"type":"string","description":"ISO-2 country code"},"required":true,"description":"ISO-2 country code","name":"countryCode","in":"path"},{"schema":{"type":"string","description":"National VAT registration number"},"required":true,"description":"National VAT registration number","name":"vatNumber","in":"path"},{"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"}],"responses":{"200":{"description":"Resolved VAT entity resource","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/VatResourceEnvelopeV2"},{"$ref":"#/components/schemas/CompactVatResourceEnvelopeV2"}]}}}},"400":{"description":"Invalid request parameters (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}},"401":{"description":"Missing or invalid authentication"}}}},"/v1/vat-validations":{"post":{"operationId":"createVatValidationV1","summary":"Certified Audit VAT Validation","description":"Creates an immutable, ledgered verification audit record with cryptographic timestamps and proof references.","security":[{"DeveloperKey":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVatValidationInput"}}}},"responses":{"200":{"description":"Saved VAT validation projected into the canonical public envelope","headers":{"Idempotency-Key":{"description":"Key to reuse with this same normalized request.","schema":{"type":"string"}},"X-Operation-Id":{"description":"The saved run ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered an existing saved result.","schema":{"type":"string","enum":["true","false"]}},"X-Usage-Charged":{"description":"Additional units for this HTTP response; always zero for a replay.","schema":{"type":"string","enum":["0","1"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVatValidationEnvelope"}}}},"400":{"description":"Invalid request, freshness policy or source capability","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"403":{"description":"Organization, scope or environment access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"409":{"description":"Idempotency conflict, unfinished or interrupted operation","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"410":{"description":"The saved result expired or was source-suppressed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"415":{"description":"JSON content type required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Request rate or monthly allowance exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"500":{"description":"Unexpected internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"503":{"description":"No successful save could be confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/v1/reference/legal-entities":{"get":{"operationId":"getLegalEntitiesV1","summary":"Legal Entity Taxonomy Catalog","description":"Lists statutory corporate forms across EU/EFTA countries with ISO 20275 ELF codes and statutory descriptions.","parameters":[{"schema":{"type":"string","description":"Filter by 2-letter ISO country code"},"required":false,"description":"Filter by 2-letter ISO country code","name":"country","in":"query"},{"schema":{"type":"string","enum":["private_limited","public_limited","general_partnership","limited_partnership","sole_proprietorship","cooperative_mutual","association_ngo","foundation_endowment","trust_fiduciary","supranational_eu","foreign_branch"],"description":"Filter by legal entity category"},"required":false,"description":"Filter by legal entity category","name":"category","in":"query"}],"responses":{"200":{"description":"List of legal form definitions with ISO ELF codes","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LegalFormDefinition"}},"total":{"type":"integer","minimum":0}},"required":["items","total"]}}}}}}},"/v1/reference/jurisdictions":{"get":{"operationId":"getJurisdictionsV1","summary":"Supported Tax Jurisdictions & Coverage","description":"Lists supported jurisdictions, VAT prefixes, certified authorities, and operational capabilities.","responses":{"200":{"description":"List of supported jurisdictions","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/JurisdictionReference"}},"total":{"type":"integer","minimum":0}},"required":["items","total"]}}}}}}},"/v1/vat/verify":{"post":{"operationId":"verifyVatV1","summary":"Official VAT Validation & Status Verification","description":"Checks supported VAT authority routes and preserves disclosed identity and consultation receipts. 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":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VatVerifyInputV1"}}}},"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":{"description":"Key to reuse with this same normalized request.","schema":{"type":"string"}},"X-Operation-Id":{"description":"The saved run ID.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"Whether this response recovered an existing saved result.","schema":{"type":"string","enum":["true","false"]}},"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"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VatVerifyEnvelopeV1"}}}},"400":{"description":"Invalid request parameters (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}},"401":{"description":"Missing or invalid authentication"},"403":{"description":"Organization, scope or environment access denied"},"409":{"description":"Idempotency conflict, in-progress or interrupted operation","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}},"410":{"description":"Saved VAT payload expired or was suppressed under its retention policy","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Monthly quota or rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}},"503":{"description":"Durable operation, saved response or authoritative usage unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}}}}},"/v1/companies/search":{"post":{"operationId":"searchCompaniesV1","summary":"Search Companies through Certified Sources","description":"Searches the certified country catalogue or retrieves an exact register identity. Preserves candidate ambiguity, source scope, partial fields and unavailable outcomes. Tax/VAT identifiers require a separately established register binding. include_vat permits certified plan validation; it does not manufacture tax identifiers or guarantee VAT discovery.","security":[{"DeveloperKey":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchInputV1"}}}},"responses":{"200":{"description":"Source-scoped candidates, observed identifier associations and explicit resolution outcomes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchEnvelopeV1"}}}},"400":{"description":"Invalid request parameters (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}},"401":{"description":"Missing or invalid authentication"},"403":{"description":"Organization, scope or environment access denied"},"409":{"description":"Idempotency key reused with a different company request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}},"410":{"description":"Saved company payload expired or was suppressed under its retention policy","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"operationId":{"type":"string","format":"uuid"},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["error"]}}}},"429":{"description":"Monthly quota or rate limit exceeded (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}}}}},"/v1/vat/calculate":{"post":{"operationId":"calculateVatV1","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":[]},{"AccountSession":[]}],"parameters":[{"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VatCalculateInputV1"}}}},"responses":{"200":{"description":"Resolved VAT rates breakdown and itemized tax calculations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VatCalculateEnvelopeV1"}}}},"400":{"description":"Invalid request parameters (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}},"401":{"description":"Missing or invalid authentication"},"403":{"description":"Organization, scope or environment access denied"},"409":{"description":"Idempotency key reused with different calculation input (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}},"429":{"description":"Monthly quota or rate limit exceeded (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetailsV2"}}}}}}}},"webhooks":{}}