{"openapi":"3.1.0","info":{"title":"TaxSorted API","version":"0.1.0","description":"Deterministic, effective-dated tax decisions and reviewed public maps, with primary sources and explicit review boundaries. TaxSorted-authored documentation, summaries and curation use CC BY-SA 4.0; linked sources retain their own terms; the server source code uses AGPL-3.0.","license":{"name":"CC BY-SA 4.0 (API documentation and TaxSorted-authored curation)","url":"https://creativecommons.org/licenses/by-sa/4.0/"}},"servers":[{"url":"https://api.taxsorted.io"}],"components":{"securitySchemes":{"WorkspaceKey":{"type":"http","scheme":"bearer","bearerFormat":"ts_test_<32-byte-secret>","description":"A TaxSorted workspace key. The SDLT calculation route requires the sdlt:calculate scope."}},"schemas":{"AgentDoorError":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.agent-error/1"]},"error":{"type":"string"},"message":{"type":"string"},"parameters":{"type":"array","items":{"type":"string"}},"nextActions":{"type":"array","items":{"$ref":"#/components/schemas/AgentNextAction"}}},"required":["schema","error","message","parameters","nextActions"]},"AgentNextAction":{"type":"object","properties":{"id":{"type":"string"},"method":{"type":"string","enum":["GET"]},"href":{"type":"string"},"accepts":{"type":"array","items":{"type":"string"}},"description":{"type":"string"}},"required":["id","method","href","accepts","description"]},"AgentWake":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.agent-wake/1"]},"service":{"type":"object","properties":{"name":{"type":"string","enum":["TaxSorted"]},"purpose":{"type":"string"},"humanDoor":{"type":"string","format":"uri"},"machineDoor":{"type":"string","format":"uri"},"jurisdiction":{"type":"string","enum":["United Kingdom"]}},"required":["name","purpose","humanDoor","machineDoor","jurisdiction"]},"access":{"type":"object","properties":{"scope":{"type":"string"},"authentication":{"type":"string","enum":["none"]},"price":{"type":"string","enum":["free"]},"cookies":{"type":"string","enum":["none"]},"methods":{"type":"array","items":{"type":"string","enum":["GET","HEAD","OPTIONS"]}},"cors":{"type":"string","enum":["*"]}},"required":["scope","authentication","price","cookies","methods","cors"]},"wallScope":{"type":"object","properties":{"appliesTo":{"type":"array","items":{"type":"string"}},"meaning":{"type":"string"},"doesNotCertify":{"type":"string"}},"required":["appliesTo","meaning","doesNotCertify"]},"walls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"statement":{"type":"string"}},"required":["id","statement"]}},"publicationStates":{"type":"array","items":{"type":"object","properties":{"datasetId":{"type":"string"},"version":{"type":"string"},"reviewedOn":{"type":["string","null"]},"status":{"type":"string"},"fullDatasetAvailable":{"type":"boolean"},"reviewBoundary":{"type":"string"},"scopeBoundary":{"type":["string","null"]}},"required":["datasetId","version","reviewedOn","status","fullDatasetAvailable","reviewBoundary"]}},"resources":{"type":"object","properties":{},"additionalProperties":{}},"evidenceLanes":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}},"nextActions":{"type":"array","items":{"$ref":"#/components/schemas/AgentNextAction"}}},"required":["schema","service","access","wallScope","walls","publicationStates","resources","evidenceLanes","nextActions"]},"OpenDataCatalog":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.open-data-catalog/1"]},"title":{"type":"string"},"purpose":{"type":"string"},"access":{"type":"object","properties":{"authentication":{"type":"string","enum":["none"]},"price":{"type":"string","enum":["free"]},"methods":{"type":"array","items":{"type":"string","enum":["GET","HEAD","OPTIONS"]}},"cors":{"type":"string","enum":["*"]},"formats":{"type":"array","items":{"type":"string","enum":["json","ndjson","csv"]}},"openApi":{"type":"string"},"rateLimits":{"type":"string"},"availability":{"type":"string"}},"required":["authentication","price","methods","cors","formats","openApi","rateLimits","availability"]},"reuse":{"type":"object","properties":{"taxSortedCurationLicence":{"$ref":"#/components/schemas/ContentLicence"},"rights":{"type":"string"},"sourceRights":{"type":"string"},"noKeyRequired":{"type":"boolean","enum":[true]},"mirroring":{"type":"string"},"corrections":{"type":"string","format":"uri"}},"required":["taxSortedCurationLicence","rights","sourceRights","noKeyRequired","mirroring","corrections"]},"datasets":{"type":"array","items":{"$ref":"#/components/schemas/OpenDataDataset"}}},"required":["schema","title","purpose","access","reuse","datasets"]},"ContentLicence":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["name","url"]},"OpenDataDataset":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"jurisdiction":{"type":"string"},"schema":{"type":"string"},"version":{"type":"string"},"reviewedOn":{"type":["string","null"]},"updatePolicy":{"type":"object","properties":{"cadence":{"type":"string"},"nextReleaseDate":{"type":["string","null"]}},"required":["cadence","nextReleaseDate"]},"correctionChannel":{"type":"object","properties":{"publicUrl":{"type":"string","format":"uri"},"accountRequired":{"type":"boolean"},"privateOrSensitiveIntakeAvailable":{"type":"boolean"},"warning":{"type":"string"}},"required":["publicUrl","accountRequired","privateOrSensitiveIntakeAvailable","warning"]},"publication":{"type":"object","properties":{"fullDatasetAvailable":{"type":"boolean"},"status":{"type":"string"},"reviewBoundary":{"type":"string"},"scopeBoundary":{"type":"string"},"notConfidentiality":{"type":"string"}},"required":["fullDatasetAvailable","reviewBoundary","notConfidentiality"]},"licence":{"type":"object","properties":{},"additionalProperties":{}},"attribution":{"type":"string"},"resources":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}},"datasetCount":{"type":"integer","minimum":0}},"required":["id","title","jurisdiction","schema","version","reviewedOn","updatePolicy","correctionChannel","publication","licence","attribution","resources"],"additionalProperties":{}},"OpenDataRights":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.open-data-rights/1"]},"status":{"type":"string","enum":["mixed-rights-read-before-reuse"]},"curation":{"type":"object","properties":{},"additionalProperties":{}},"curationAppliesTo":{"type":"string"},"sourceMaterial":{"type":"string"},"automationRule":{"type":"string"},"datasetRights":{"type":"object","additionalProperties":{"type":"string"}},"publicIssueTracker":{"type":"string","format":"uri"},"correctionChannel":{"type":"object","properties":{"publicUrl":{"type":"string","format":"uri"},"accountRequired":{"type":"boolean"},"privateOrSensitiveIntakeAvailable":{"type":"boolean"},"warning":{"type":"string"}},"required":["publicUrl","accountRequired","privateOrSensitiveIntakeAvailable","warning"]}},"required":["schema","status","curation","curationAppliesTo","sourceMaterial","automationRule","datasetRights","publicIssueTracker","correctionChannel"]},"UkTaxSystemResponse":{"type":"object","properties":{},"additionalProperties":{}},"DataDictionary":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.open-data-dictionary/1"]},"dataset":{"type":"string"},"corpusSchema":{"type":"string"},"version":{"type":"string"},"reviewedOn":{"type":"string"},"structuralSchema":{"type":"string","format":"uri"},"corrections":{"type":"string","format":"uri"},"correctionSafety":{"type":"string"},"scope":{"type":"object","properties":{},"additionalProperties":{}},"validation":{"type":"object","properties":{"structuralSchema":{"type":"string"},"bootOnlyInvariants":{"type":"array","items":{"type":"string"}}},"required":["structuralSchema","bootOnlyInvariants"]},"conventions":{"type":"object","additionalProperties":{"type":"string"}},"formats":{"type":"object","additionalProperties":{"type":"string"}},"collections":{"type":"array","items":{"$ref":"#/components/schemas/DictionaryCollection"}}},"required":["schema","dataset","corpusSchema","version","reviewedOn","structuralSchema","corrections","validation","conventions","formats","collections"]},"DictionaryCollection":{"type":"object","properties":{"pathName":{"type":"string"},"corpusKey":{"type":"string"},"description":{"type":"string"},"count":{"type":"integer","minimum":0},"identityField":{"type":"string","enum":["id"]},"itemUrlTemplate":{"type":"string"},"queryUrl":{"type":"string"},"queryFilters":{"type":"array","items":{"type":"string"}},"schemaPointer":{"type":"string","format":"uri"},"references":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},"csvColumns":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DictionaryField"}}},"required":["pathName","corpusKey","description","count","identityField","itemUrlTemplate","queryUrl","queryFilters","schemaPointer","references","csvColumns","fields"]},"DictionaryField":{"type":"object","properties":{"name":{"type":"string"},"field":{"type":"string"},"type":{"type":"string"},"required":{"type":"boolean"},"requiredWithin":{"type":"string"},"nullable":{"type":"boolean"},"meaning":{"type":"string"},"allowedValues":{"type":"array","items":{}}},"required":["name","field","type","required","requiredWithin","nullable","meaning"]},"DatasetExportIndex":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.open-data-exports/1"]},"dataset":{"type":"string"},"version":{"type":"string"},"reviewedOn":{"type":"string"},"licence":{"$ref":"#/components/schemas/ContentLicence"},"publicationStatus":{"type":"string"},"attribution":{"type":"string"},"attributionInstructions":{"type":"string"},"corrections":{"type":"string","format":"uri"},"correctionSafety":{"type":"string"},"rules":{"type":"object","additionalProperties":{"type":"string"}},"collections":{"type":"array","items":{"$ref":"#/components/schemas/ExportCollection"}}},"required":["schema","dataset","version","reviewedOn","licence","attribution","attributionInstructions","corrections","rules","collections"]},"ExportCollection":{"type":"object","properties":{"pathName":{"type":"string"},"corpusKey":{"type":"string"},"count":{"type":"integer","minimum":0},"available":{"type":"boolean"},"csvColumns":{"type":"array","items":{"type":"string"}},"formats":{"type":"object","properties":{"json":{"$ref":"#/components/schemas/ExportFormatLink"},"ndjson":{"$ref":"#/components/schemas/ExportFormatLink"},"csv":{"$ref":"#/components/schemas/ExportFormatLink"}},"required":["json","ndjson","csv"]}},"required":["pathName","corpusKey","count","available","csvColumns","formats"]},"ExportFormatLink":{"type":"object","properties":{"href":{"type":"string"},"type":{"type":"string"},"mediaType":{"type":"string"},"filename":{"type":"string"},"bytes":{"type":"integer","minimum":0},"etag":{"type":"string"}},"required":["href","type","mediaType","filename","bytes","etag"]},"OpenDataRecord":{"type":"object","properties":{"id":{"type":"string","description":"Stable, dataset-wide record identifier."}},"required":["id"],"additionalProperties":{}},"UkTaxIndustryResponse":{"type":"object","properties":{},"additionalProperties":{}},"UkCharitiesResponse":{"type":"object","properties":{},"additionalProperties":{}},"UkPublicFundingList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/UkPublicFundingRecord"}},"page":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"}},"required":["total","returned","limit","offset","hasMore"]},"links":{"type":"object","properties":{"self":{"type":"string"},"next":{"type":["string","null"]},"prev":{"type":["string","null"]}},"required":["self","next","prev"]},"filters":{"type":"object","additionalProperties":{"type":"string"}},"provenance":{"type":"object","properties":{"corpusVersion":{"type":"string"},"reviewedOn":{"type":"string"},"sourceLedger":{"type":"string"},"gaps":{"type":"string"}},"required":["corpusVersion","reviewedOn","sourceLedger","gaps"]}},"required":["data","page","links","filters","provenance"]},"UkPublicFundingRecord":{"type":"object","properties":{"id":{"type":"string","description":"Stable, dataset-wide record identifier."}},"required":["id"],"additionalProperties":{}},"UkPublicFundingUnavailable":{"type":"object","properties":{"error":{"type":"string","enum":["publication_review_pending","publication_emergency_stopped"]},"message":{"type":"string"},"sources":{"type":"string"},"gaps":{"type":"string"},"nextActions":{"type":"array","items":{"$ref":"#/components/schemas/UkPublicFundingNextAction"},"minItems":1}},"required":["error","message","sources","gaps","nextActions"],"additionalProperties":{}},"UkPublicFundingNextAction":{"type":"object","properties":{"method":{"type":"string","enum":["GET"]},"href":{"type":"string"},"description":{"type":"string"}},"required":["method","href","description"]},"UkPublicFundingDetail":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/UkPublicFundingRecord"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/UkPublicFundingRecord"}}},"required":["data"],"additionalProperties":{}},"UkPublicFundingChangeFeed":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.uk.public-funding.changes/1"]},"dataset":{"type":"string","enum":["uk-public-funding"]},"appendOnly":{"type":"boolean","enum":[true]},"cursorSemantics":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/UkPublicFundingChange"}},"page":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"returned":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"]}},"required":["limit","returned","hasMore","nextCursor"]},"links":{"type":"object","properties":{"self":{"type":"string"},"next":{"type":["string","null"]},"poll":{"type":["string","null"]}},"required":["self","next","poll"]}},"required":["schema","dataset","appendOnly","cursorSemantics","data","page","links"]},"UkPublicFundingChange":{"type":"object","properties":{"id":{"type":"string"},"sequence":{"type":"integer","exclusiveMinimum":0},"cursor":{"type":"string"},"operation":{"type":"string","enum":["snapshot-established","added","updated","retired"]},"dataset":{"type":"string","enum":["uk-public-funding"]},"version":{"type":"string"},"reviewedOn":{"type":"string"},"publishedOn":{"type":"string"},"releaseCommit":{"type":"string","pattern":"^[0-9a-f]{40}$"},"previousEventHash":{"type":["string","null"]},"eventHash":{"type":"string"},"datasetHash":{"type":"string"},"counts":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"collection":{"type":"string"},"recordId":{"type":"string"},"changedFields":{"type":"array","items":{"type":"string"}},"beforeHash":{"type":["string","null"]},"afterHash":{"type":["string","null"]},"reason":{"type":"string"},"sourceIds":{"type":"array","items":{"type":"string"}},"explanation":{"type":"string"},"doesNotClaim":{"type":"array","items":{"type":"string"}}},"required":["id","sequence","cursor","operation","dataset","version","reviewedOn","publishedOn","releaseCommit","previousEventHash","eventHash","datasetHash","counts","explanation","doesNotClaim"]},"UkPublicFundingActionError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"nextActions":{"type":"array","items":{"$ref":"#/components/schemas/UkPublicFundingNextAction"},"minItems":1}},"required":["error","message","nextActions"],"additionalProperties":{}},"UkPublicFundingResolvedRecord":{"type":"object","properties":{"collection":{"type":"string","enum":["sources","institutions","governance","offices","relationships","funds","programmes","mechanisms","allocations","contacts","locations","pipeline","gaps"]},"corpusKey":{"type":"string"},"canonicalUrl":{"type":"string"},"data":{"$ref":"#/components/schemas/UkPublicFundingRecord"},"links":{"type":"object","properties":{"self":{"type":"string"},"canonical":{"type":"string"}},"required":["self","canonical"]}},"required":["collection","corpusKey","canonicalUrl","data","links"]},"UkPublicFundingResponse":{"type":"object","properties":{},"additionalProperties":{}},"UkPoliticsOpenDataResponse":{"type":"object","properties":{},"additionalProperties":{}},"UkPoliticsDatasetCatalogue":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.uk.open-dataset-catalog/1"]},"title":{"type":"string"},"purpose":{"type":"string"},"access":{"type":"object","properties":{},"additionalProperties":{}},"licence":{"type":"object","properties":{},"additionalProperties":{}},"datasets":{"type":"array","items":{"$ref":"#/components/schemas/UkPoliticsDatasetDescriptor"}},"queryServices":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}},"links":{"type":"object","properties":{},"additionalProperties":{}}},"required":["schema","title","purpose","access","licence","datasets","queryServices","links"],"additionalProperties":{}},"UkPoliticsDatasetDescriptor":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"availability":{"type":"string","enum":["open","development-preview","approved-disabled","publication-review","emergency-stopped"]},"authentication":{"type":"string","enum":["none"]},"containsPersonalRecords":{"type":"boolean","enum":[false]},"schemaVersion":{"type":"string"},"datasetVersion":{"type":"string"},"primaryKey":{"type":"string","enum":["id"]},"recordCount":{"type":"integer","minimum":0},"fields":{"type":"array","items":{"$ref":"#/components/schemas/UkPoliticsDatasetField"}},"sourceIds":{"type":"array","items":{"type":"string"}},"links":{"type":"object","properties":{},"additionalProperties":{}},"distributions":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["id","title","description","availability","authentication","containsPersonalRecords","schemaVersion","datasetVersion","primaryKey","recordCount","fields","sourceIds","links","distributions"],"additionalProperties":{}},"UkPoliticsDatasetField":{"type":"object","properties":{"name":{"type":"string"},"types":{"type":"array","items":{"type":"string"}},"nullable":{"type":"boolean"},"optional":{"type":"boolean"},"required":{"type":"boolean"},"csvEncoding":{"type":"string","enum":["scalar","canonical-json-in-cell"]}},"required":["name","types","nullable","optional","required","csvEncoding"]},"UkPoliticsDatasetEnvelope":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.open-dataset/1"]},"dataset":{"$ref":"#/components/schemas/UkPoliticsDatasetDescriptor"},"data":{"type":"array","items":{"$ref":"#/components/schemas/OpenDataRecord"}},"links":{"type":"object","properties":{},"additionalProperties":{}}},"required":["schema","dataset","data","links"]},"SdltCalculatedResponse":{"type":"object","properties":{"status":{"type":"string","enum":["calculated"]},"calculation":{"$ref":"#/components/schemas/SdltCalculation"},"reviewReasons":{"type":"array","items":{"$ref":"#/components/schemas/ReviewReason"},"maxItems":0},"trust":{"$ref":"#/components/schemas/TaxDecisionTrust"}},"required":["status","calculation","reviewReasons","trust"]},"SdltCalculation":{"type":"object","properties":{"currency":{"type":"string","enum":["GBP"]},"effectiveDate":{"type":"string","format":"date"},"chargeableConsiderationPence":{"type":"integer","minimum":0},"taxBeforeRoundingPence":{"type":"number","minimum":0},"taxDuePence":{"type":"integer","minimum":0},"rounding":{"type":"string","enum":["down-to-whole-pound"]},"roundingAdjustmentPence":{"type":"number","minimum":0,"exclusiveMaximum":100},"regime":{"type":"string","enum":["standard","first-time-buyer","higher-rates"]},"treatmentsApplied":{"type":"array","items":{"type":"string","enum":["standard-residential","first-time-buyer-relief","higher-rates-transaction","non-resident-surcharge"]}},"bands":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"fromPence":{"type":"integer","minimum":0},"upToPence":{"type":["integer","null"],"exclusiveMinimum":0},"amountTaxedPence":{"type":"integer","minimum":0},"baseRateBasisPoints":{"type":"integer","minimum":0},"surchargeBasisPoints":{"type":"integer","minimum":0},"rateBasisPoints":{"type":"integer","minimum":0},"taxPenceBeforeFinalRounding":{"type":"number","minimum":0},"sourceIds":{"type":"array","items":{"type":"string"}}},"required":["label","fromPence","upToPence","amountTaxedPence","baseRateBasisPoints","surchargeBasisPoints","rateBasisPoints","taxPenceBeforeFinalRounding","sourceIds"]}},"decisions":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"sourceIds":{"type":"array","items":{"type":"string"}}},"required":["code","message","sourceIds"]}},"explanation":{"type":"array","items":{"type":"string"}}},"required":["currency","effectiveDate","chargeableConsiderationPence","taxBeforeRoundingPence","taxDuePence","rounding","roundingAdjustmentPence","regime","treatmentsApplied","bands","decisions","explanation"]},"ReviewReason":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"sourceIds":{"type":"array","items":{"type":"string"}}},"required":["code","message","sourceIds"]},"TaxDecisionTrust":{"type":"object","properties":{"method":{"type":"string","enum":["deterministic"]},"requestHash":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"ruleset":{"type":"object","properties":{"id":{"type":"string"},"revision":{"type":"string"},"effectiveFrom":{"type":"string","format":"date"},"effectiveTo":{"type":["string","null"],"format":"date"},"reviewedOn":{"type":"string","format":"date"}},"required":["id","revision","effectiveFrom","effectiveTo","reviewedOn"]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/TaxRuleSource"}},"assumptions":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["method","requestHash","ruleset","sources","assumptions"]},"TaxRuleSource":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"authority":{"type":"string","enum":["UK Parliament","HM Revenue & Customs"]},"url":{"type":"string","format":"uri"},"checkedOn":{"type":"string","format":"date"}},"required":["id","title","authority","url","checkedOn"]},"SdltNeedsReviewResponse":{"type":"object","properties":{"status":{"type":"string","enum":["needs_review"]},"calculation":{"type":"null"},"reviewReasons":{"type":"array","items":{"$ref":"#/components/schemas/ReviewReason"},"minItems":1},"trust":{"$ref":"#/components/schemas/TaxDecisionTrust"}},"required":["status","calculation","reviewReasons","trust"]},"ApiError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["path","code","message"]}}},"required":["error","message"]},"SdltCalculationRequest":{"type":"object","properties":{"effectiveDate":{"type":"string","format":"date","description":"The legal SDLT effective date. This is normally completion, but substantial performance can make it earlier.","example":"2026-07-10"},"chargeableConsiderationPence":{"type":"integer","minimum":0,"maximum":1000000000000,"description":"Total chargeable consideration in integer pence, capped at £10 billion in this scope. Supply the legal consideration, not merely a headline purchase price.","example":29500000},"land":{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["england","northern-ireland","scotland","wales","unknown"],"example":"england"},"use":{"type":"string","enum":["residential","mixed","non-residential","unknown"],"example":"residential"},"interest":{"type":"string","enum":["freehold","existing-lease","new-lease","unknown"],"example":"freehold"},"dwellingCount":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"string","enum":["unknown"]}],"example":1}},"required":["jurisdiction","use","interest","dwellingCount"],"additionalProperties":false},"buyerKind":{"type":"string","enum":["individual","company","trust","partnership","other","unknown"],"example":"individual"},"treatment":{"type":"object","properties":{"firstTimeBuyerRelief":{"type":"string","enum":["claim","do-not-claim","unknown"],"example":"do-not-claim"},"higherRates":{"type":"string","enum":["standard","additional-dwelling","unknown"],"description":"The caller's Schedule 4ZA classification. Do not reduce this to a simple owns-another-property flag.","example":"standard"},"nonResidentSurcharge":{"type":"string","enum":["apply","do-not-apply","unknown"],"description":"The caller's section 75ZA and Schedule 9A classification.","example":"do-not-apply"}},"required":["firstTimeBuyerRelief","higherRates","nonResidentSurcharge"],"additionalProperties":false},"specialCases":{"type":"object","properties":{"linkedTransactions":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["unknown"]}],"example":false},"sharedOwnership":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["unknown"]}],"example":false},"otherReliefClaimed":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["unknown"]}],"example":false},"complexConsideration":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["unknown"]}],"description":"True for contingent, uncertain, non-cash, debt, VAT or disputed-apportionment cases unless a professional has supplied final chargeable consideration.","example":false},"transitionalContractMayApply":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["unknown"]}],"description":"True or unknown where an older protected contract may retain pre-change treatment.","example":false}},"required":["linkedTransactions","sharedOwnership","otherReliefClaimed","complexConsideration","transitionalContractMayApply"],"additionalProperties":false}},"required":["effectiveDate","chargeableConsiderationPence","land","buyerKind","treatment","specialCases"],"additionalProperties":false}},"parameters":{}},"paths":{"/agent.txt":{"get":{"operationId":"getAgentManifest","summary":"Read the TaxSorted machine doorway manifest","description":"Flat, ordered orientation for machine callers: public doors, formats, rights, corrections and hard safety walls. It is XENIA-inspired; no conformance claim is made.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"},{"schema":{"type":"string","description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations."},"required":false,"description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations.","name":"Accept","in":"header"}],"responses":{"200":{"description":"Current machine manifest.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"text/plain":{"schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies these exact manifest bytes.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Machine manifest routes do not accept query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDoorError"}}}}}},"head":{"operationId":"headAgentManifest","summary":"Check the TaxSorted machine doorway manifest","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"},{"schema":{"type":"string","description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations."},"required":false,"description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations.","name":"Accept","in":"header"}],"responses":{"200":{"description":"Current manifest metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The manifest is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Machine manifest routes do not accept query parameters."}}}},"/.well-known/agent.txt":{"get":{"operationId":"getWellKnownAgentManifest","summary":"Read the TaxSorted machine doorway manifest","description":"Flat, ordered orientation for machine callers: public doors, formats, rights, corrections and hard safety walls. It is XENIA-inspired; no conformance claim is made.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"},{"schema":{"type":"string","description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations."},"required":false,"description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations.","name":"Accept","in":"header"}],"responses":{"200":{"description":"Current machine manifest.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"text/plain":{"schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies these exact manifest bytes.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Machine manifest routes do not accept query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDoorError"}}}}}},"head":{"operationId":"headWellKnownAgentManifest","summary":"Check the TaxSorted machine doorway manifest","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"},{"schema":{"type":"string","description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations."},"required":false,"description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations.","name":"Accept","in":"header"}],"responses":{"200":{"description":"Current manifest metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The manifest is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Machine manifest routes do not accept query parameters."}}}},"/v1/wake":{"get":{"operationId":"wakeTaxSortedAgent","summary":"Arrive oriented at TaxSorted","description":"Deterministic, stateless projection of the open-data catalogue: publication states, resource handles, evidence lanes, safety walls and typed next actions. The caller keeps its own cursor and TaxSorted creates no identity session.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"},{"schema":{"type":"string","description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations."},"required":false,"description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations.","name":"Accept","in":"header"}],"responses":{"200":{"description":"Current stateless machine orientation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentWake"}}}},"304":{"description":"The supplied ETag still identifies these exact wake bytes.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Wake routes do not accept query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDoorError"}}}}}},"head":{"operationId":"headTaxSortedAgentWake","summary":"Check: Arrive oriented at TaxSorted","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"},{"schema":{"type":"string","description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations."},"required":false,"description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations.","name":"Accept","in":"header"}],"responses":{"200":{"description":"Current wake metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The wake representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Wake routes do not accept query parameters."}}}},"/":{"get":{"operationId":"negotiateTaxSortedAgentWake","summary":"Negotiate machine orientation at the API root","description":"Returns the exact /v1/wake JSON when Accept includes application/json with non-zero quality. Other media types retain the default 404.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"},{"schema":{"type":"string","description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations."},"required":false,"description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations.","name":"Accept","in":"header"}],"responses":{"200":{"description":"Current stateless machine orientation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentWake"}}}},"304":{"description":"The supplied ETag still identifies these exact wake bytes.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Wake routes do not accept query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDoorError"}}}},"404":{"description":"The API root remains a closed door unless JSON is requested."}}},"head":{"operationId":"headNegotiatedTaxSortedAgentWake","summary":"Check: Negotiate machine orientation at the API root","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"},{"schema":{"type":"string","description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations."},"required":false,"description":"Request JSON at the API root; canonical wake and manifest routes have fixed representations.","name":"Accept","in":"header"}],"responses":{"200":{"description":"Current wake metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The wake representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Wake routes do not accept query parameters."},"404":{"description":"The API root remains a closed door unless JSON is requested."}}}},"/v1/open-data":{"get":{"operationId":"listOpenDataDatasets","summary":"Discover TaxSorted public datasets","description":"Public, sessionless catalog of tax-system, tax-industry, charity-sector, public-funding and politics/public-integrity datasets, licences, review dates, schemas, dictionaries and bulk exports. No API key is read or required.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Open-data catalog and reuse contract.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenDataCatalog"}}}},"304":{"description":"This exact catalog representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"summary":"Check the open-data catalogue","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/open-data/rights":{"get":{"operationId":"getOpenDataRights","summary":"Read the curation and source-rights boundary","description":"Machine-readable warning that TaxSorted's curation licence does not replace source-specific rights or personal-data duties.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Mixed-rights statement and dataset-specific rights routes.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenDataRights"}}}},"304":{"description":"This exact rights statement is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"summary":"Check the mixed-rights statement","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-system/uk":{"get":{"operationId":"getUkTaxSystemOverview","summary":"Map the UK tax system","description":"Public, sessionless overview of actors, authority, accounts, collection lanes, permissions, evidence and known gaps.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Dataset overview, route map, counts and review boundary.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkTaxSystemResponse"}}}},"304":{"description":"This exact overview is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxSystemOverview","summary":"Check the UK tax-system overview","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-system/uk/map":{"get":{"operationId":"redirectUkTaxSystemMap","summary":"Follow the legacy UK tax-system map route","description":"Compatibility redirect to the canonical tax-system overview.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"304":{"description":"The redirect representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"308":{"description":"Permanent redirect to /v1/tax-system/uk.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Location":{"description":"Canonical route to request instead.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxSystemMapRedirect","summary":"Check the legacy UK tax-system map redirect","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"304":{"description":"The redirect representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"308":{"description":"Permanent redirect metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Location":{"description":"Canonical route to request instead.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-system/uk/{collection}":{"get":{"operationId":"queryUkTaxSystemCollection","summary":"Query a UK tax-system collection","security":[],"parameters":[{"schema":{"type":"string","enum":["actors","relationships","frameworks","rules","accounts","systems","permissions","pipeline","cases","sources","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sector","in":"query"},{"schema":{"type":"string"},"required":false,"name":"category","in":"query"},{"schema":{"type":"string"},"required":false,"name":"layer","in":"query"},{"schema":{"type":"string"},"required":false,"name":"lane","in":"query"},{"schema":{"type":"string"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"authority","in":"query"},{"schema":{"type":"string"},"required":false,"name":"jurisdiction","in":"query"},{"schema":{"type":"string"},"required":false,"name":"actorId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"stageId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"ruleId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"systemId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sourceId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Filtered records with paging and provenance metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkTaxSystemResponse"}}}},"304":{"description":"This exact query representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown or invalid filter."},"503":{"description":"Full graph publication remains closed; sources and gaps stay public."}}},"head":{"operationId":"headUkTaxSystemCollectionQuery","summary":"Check a UK tax-system collection query","description":"Returns the GET query's validators and links without its response body.","security":[],"parameters":[{"schema":{"type":"string","enum":["actors","relationships","frameworks","rules","accounts","systems","permissions","pipeline","cases","sources","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sector","in":"query"},{"schema":{"type":"string"},"required":false,"name":"category","in":"query"},{"schema":{"type":"string"},"required":false,"name":"layer","in":"query"},{"schema":{"type":"string"},"required":false,"name":"lane","in":"query"},{"schema":{"type":"string"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"authority","in":"query"},{"schema":{"type":"string"},"required":false,"name":"jurisdiction","in":"query"},{"schema":{"type":"string"},"required":false,"name":"actorId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"stageId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"ruleId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"systemId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sourceId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current query metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this query representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown or invalid filter."},"503":{"description":"Full graph publication remains closed; sources and gaps stay public."}}}},"/v1/tax-system/uk/{collection}/{id}":{"get":{"operationId":"getUkTaxSystemRecord","summary":"Read one evidence-backed UK tax-system record","security":[],"parameters":[{"schema":{"type":"string","enum":["actors","relationships","frameworks","rules","accounts","systems","permissions","pipeline","cases","sources","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"The record and its resolved sources; actor records include joined relations.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkTaxSystemResponse"}}}},"304":{"description":"This exact record representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Detail routes do not accept query parameters."},"404":{"description":"No record with that ID in the collection."},"503":{"description":"Full graph publication remains closed."}}},"head":{"operationId":"headUkTaxSystemRecord","summary":"Check one UK tax-system record","description":"Returns the record's validators and links without its response body.","security":[],"parameters":[{"schema":{"type":"string","enum":["actors","relationships","frameworks","rules","accounts","systems","permissions","pipeline","cases","sources","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current record metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this record representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Detail routes do not accept query parameters."},"404":{"description":"No record with that ID in the collection."},"503":{"description":"Full graph publication remains closed."}}}},"/v1/tax-system/uk/graph":{"get":{"operationId":"downloadUkTaxSystemGraph","summary":"Download the complete reviewed UK tax-system graph","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"The complete static corpus, including source limitations and gaps.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.uk.tax-system/1"]},"meta":{"type":"object","properties":{"title":{"type":"string","minLength":1},"version":{"type":"string","minLength":1},"reviewedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","enum":["United Kingdom"]},"coverage":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"exclusions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"editorialRules":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"contentLicence":{"type":"object","properties":{"name":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false},"warning":{"type":"string","minLength":1}},"required":["title","version","reviewedOn","jurisdiction","coverage","exclusions","editorialRules","contentLicence","warning"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"title":{"type":"string","minLength":1},"publisher":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"authorityLevel":{"type":"string","enum":["primary-law","judgment","official-policy","official-guidance","official-manual","official-register","public-audit","parliamentary-scrutiny","professional-regulator"]},"reviewedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"reviewAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"lastUpdated":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"status":{"type":"string","enum":["current","historical","pending","partly-current"]},"reuseStatus":{"type":"string","enum":["confirmed","link-only","unknown"]},"publicationMode":{"type":"string","enum":["normalised-summary","metadata-only","link-only"]},"supports":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"doesNotProve":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"licence":{"type":["object","null"],"properties":{"name":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"}},"required":["name"],"additionalProperties":false}},"required":["id","title","publisher","url","authorityLevel","reviewedOn","reviewAfter","status","reuseStatus","publicationMode","supports","doesNotProve","licence"],"additionalProperties":false},"minItems":1},"actors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"sector":{"type":"string","enum":["public","private","professional","judicial","parliamentary"]},"kind":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"roles":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"explanation":{"type":"string","minLength":1},"whyItExists":{"type":"string","minLength":1},"website":{"type":"string","format":"uri"},"contacts":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"kind":{"type":"string","enum":["contact-page","email","phone","postal-address","register"]},"value":{"type":"string","minLength":1}},"required":["label","kind","value"],"additionalProperties":false}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"transparencyNotes":{"type":"array","items":{"type":"string","minLength":1}},"activeFrom":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"activeTo":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["id","name","sector","kind","jurisdictions","roles","explanation","whyItExists","website","contacts","sourceIds","evidence","transparencyNotes"],"additionalProperties":false},"minItems":1},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fromActorId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"toActorId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"type":{"type":"string","enum":["creates-rules-for","appoints","administers","oversees","audits","hears-appeals-from","investigates-for","prosecutes-cases-from","supplies-data-to","collects-for","contracts-with","regulates","authorises","recognises","complaints-escalate-to"]},"explanation":{"type":"string","minLength":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"validFrom":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"validTo":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["id","fromActorId","toActorId","type","explanation","sourceIds","evidence"],"additionalProperties":false}},"frameworks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"publicRationale":{"type":"string","minLength":1},"howItWorks":{"type":"string","minLength":1},"tension":{"type":"string","minLength":1},"ruleIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","publicRationale","howItWorks","tension","ruleIds","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"title":{"type":"string","minLength":1},"kind":{"type":"string","enum":["act","regulations","code","charter","internal-framework"]},"explanation":{"type":"string","minLength":1},"madeByActorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"administeredByActorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"enforcedByActorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"effectiveFrom":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"volatile":{"type":"boolean"}},"required":["id","title","kind","explanation","madeByActorIds","administeredByActorIds","enforcedByActorIds","sourceIds","evidence","volatile"],"additionalProperties":false},"minItems":1},"accountTypes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"category":{"type":"string","enum":["identity","taxpayer-view","agent","tax-ledger","payment-reference","developer"]},"holder":{"type":"string","minLength":1},"operatorActorIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"purpose":{"type":"string","minLength":1},"identifiers":{"type":"array","items":{"type":"string","minLength":1}},"accessAndAuthority":{"type":"string","minLength":1},"accountEffects":{"type":"string","minLength":1},"notTheSameAs":{"type":"array","items":{"type":"string","minLength":1}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"transparencyNotes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["id","name","category","holder","operatorActorIds","purpose","identifiers","accessAndAuthority","accountEffects","notTheSameAs","sourceIds","evidence","transparencyNotes"],"additionalProperties":false},"minItems":1},"systems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"layer":{"type":"string","enum":["identity","filing","ledger","payment","debt","risk","integration"]},"operatorActorIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"purpose":{"type":"string","minLength":1},"inputs":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"outputs":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"connectedSystemIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"privatePartnerActorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"publicVisibility":{"type":"string","enum":["public-service","documented-in-manuals","partly-disclosed","historical-disclosure"]},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"transparencyNotes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["id","name","layer","operatorActorIds","purpose","inputs","outputs","connectedSystemIds","privatePartnerActorIds","publicVisibility","sourceIds","evidence","transparencyNotes"],"additionalProperties":false},"minItems":1},"permissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"category":{"type":"string","enum":["licence","authorisation","registration","supervision","certificate","recognition","access"]},"requiredFor":{"type":"string","minLength":1},"holderTypes":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"grantedByActorIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"overseenByActorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"publicRegister":{"type":["string","null"],"format":"uri"},"enforcement":{"type":"string","minLength":1},"notEquivalentTo":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"effectiveFrom":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["id","name","category","requiredFor","holderTypes","grantedByActorIds","overseenByActorIds","publicRegister","enforcement","notEquivalentTo","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"pipelineStages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"lane":{"type":"string","enum":["hmrc-main","local-tax","devolved-tax","criminal-tax"]},"order":{"type":"integer","minimum":0},"name":{"type":"string","minLength":1},"trigger":{"type":"string","minLength":1},"collectorActorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"otherActorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"whatHappens":{"type":"string","minLength":1},"whyItExists":{"type":"string","minLength":1},"inputs":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"outputs":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"accountEffects":{"type":"string","minLength":1},"rightsAndSafeguards":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"ruleIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"systemIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"nextStageIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","lane","order","name","trigger","collectorActorIds","otherActorIds","whatHappens","whyItExists","inputs","outputs","accountEffects","rightsAndSafeguards","ruleIds","systemIds","nextStageIds","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"cases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"citation":{"type":"string","minLength":1},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"status":{"type":"string","enum":["decided","pending"]},"courtActorId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"issue":{"type":"string","minLength":1},"outcome":{"type":"string","minLength":1},"whyItMatters":{"type":"string","minLength":1},"stageIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","citation","date","status","courtActorId","issue","outcome","whyItMatters","stageIds","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"transparencyGaps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"title":{"type":"string","minLength":1},"detail":{"type":"string","minLength":1},"consequence":{"type":"string","minLength":1},"status":{"type":"string","enum":["open","source-conflict","time-sensitive","bounded-by-design"]},"affectedIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","title","detail","consequence","status","affectedIds","sourceIds","evidence"],"additionalProperties":false},"minItems":1}},"required":["schema","meta","sources","actors","relationships","frameworks","rules","accountTypes","systems","permissions","pipelineStages","cases","transparencyGaps"],"additionalProperties":false}}}},"304":{"description":"The supplied ETag still identifies this exact graph.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."},"503":{"description":"Full graph publication remains closed."}}},"head":{"operationId":"headUkTaxSystemGraph","summary":"Check the complete UK tax-system graph","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."},"503":{"description":"Full graph publication remains closed."}}}},"/v1/tax-system/uk/manifest":{"get":{"operationId":"getUkTaxSystemManifest","summary":"Read the UK tax-system release manifest","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Version, review date, deterministic graph-byte SHA-256, counts, licence and distribution links.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkTaxSystemResponse"}}}},"304":{"description":"This exact manifest is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxSystemManifest","summary":"Check the UK tax-system manifest","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-system/uk/schema":{"get":{"operationId":"getUkTaxSystemSchema","summary":"Read the structural UK tax-system JSON Schema","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Structural JSON Schema generated from the Zod record shape; the dictionary lists boot-only graph invariants.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/schema+json":{"schema":{"$ref":"#/components/schemas/UkTaxSystemResponse"}}}},"304":{"description":"This exact schema is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxSystemSchema","summary":"Check the UK tax-system structural schema","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-system/uk/dictionary":{"get":{"operationId":"getUkTaxSystemDictionary","summary":"Read the plain-language UK tax-system data dictionary","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Collection aliases, meanings, filters, references, CSV columns and reuse conventions.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataDictionary"}}}},"304":{"description":"This exact dictionary is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxSystemDictionary","summary":"Check the UK tax-system dictionary","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-system/uk/exports":{"get":{"operationId":"listUkTaxSystemExports","summary":"List complete UK tax-system collection exports","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Format links, filenames, sizes and exact-byte ETags for every collection.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetExportIndex"}}}},"304":{"description":"This exact export index is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxSystemExports","summary":"Check the UK tax-system export index","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-system/uk/exports/{collection}/{format}":{"get":{"operationId":"downloadUkTaxSystemCollection","summary":"Download one complete UK tax-system collection","description":"JSON and NDJSON use lossless TaxSorted deterministic JSON (not RFC 8785/JCS). CSV keeps nested values as deterministic JSON and mitigates common spreadsheet-formula prefixes.","security":[],"parameters":[{"schema":{"type":"string","enum":["actors","relationships","frameworks","rules","accounts","systems","permissions","pipeline","cases","sources","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","enum":["json","ndjson","csv"]},"required":true,"name":"format","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Complete, unpaginated collection attachment.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenDataRecord"}}},"application/x-ndjson":{"schema":{"type":"string"}},"text/csv":{"schema":{"type":"string"}}}},"304":{"description":"This exact export format is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"400":{"description":"Static export routes do not accept query parameters."},"404":{"description":"Unknown collection or format."},"503":{"description":"This collection is still inside the publication review boundary."}}},"head":{"operationId":"headUkTaxSystemCollectionExport","summary":"Check one UK tax-system collection export","description":"Returns download validators, size-independent links and filename without the export body.","security":[],"parameters":[{"schema":{"type":"string","enum":["actors","relationships","frameworks","rules","accounts","systems","permissions","pipeline","cases","sources","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","enum":["json","ndjson","csv"]},"required":true,"name":"format","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current export metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this export.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"400":{"description":"Static export routes do not accept query parameters."},"404":{"description":"Unknown collection or format."},"503":{"description":"This collection is still inside the publication review boundary."}}}},"/v1/tax-industry/uk":{"get":{"operationId":"getUkTaxIndustryOverview","summary":"Map entry into the UK tax-services industry","description":"Public, sessionless overview of roles, qualifications, legal and market gates, pathways, pay evidence, barriers and source limitations.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Dataset overview, route map, counts and review boundary.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkTaxIndustryResponse"}}}},"304":{"description":"This exact overview is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxIndustryOverview","summary":"Check the UK tax-industry overview","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-industry/uk/map":{"get":{"operationId":"redirectUkTaxIndustryMap","summary":"Follow the legacy UK tax-industry map route","description":"Compatibility redirect to the canonical tax-industry overview.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"304":{"description":"The redirect representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"308":{"description":"Permanent redirect to /v1/tax-industry/uk.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Location":{"description":"Canonical route to request instead.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxIndustryMapRedirect","summary":"Check the legacy UK tax-industry map redirect","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"304":{"description":"The redirect representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"308":{"description":"Permanent redirect metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Location":{"description":"Canonical route to request instead.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-industry/uk/{collection}":{"get":{"operationId":"queryUkTaxIndustryCollection","summary":"Query a UK tax-industry collection","description":"Filters are collection-specific; unsupported filters return 400. Pathway gateId and qualificationId filters inspect pathway steps.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","roles","qualifications","gates","pathways","study","compensation","barriers","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"category","in":"query"},{"schema":{"type":"string"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"legalStatus","in":"query"},{"schema":{"type":"string"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"gateId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"roleId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"qualificationId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"institutionId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sourceId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Filtered records with paging and provenance metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkTaxIndustryResponse"}}}},"304":{"description":"This exact query representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown or invalid filter."},"503":{"description":"Full map publication remains closed; sources and gaps stay public."}}},"head":{"operationId":"headUkTaxIndustryCollectionQuery","summary":"Check a UK tax-industry collection query","description":"Returns the GET query's validators and links without its response body.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","roles","qualifications","gates","pathways","study","compensation","barriers","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"category","in":"query"},{"schema":{"type":"string"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"legalStatus","in":"query"},{"schema":{"type":"string"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"gateId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"roleId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"qualificationId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"institutionId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sourceId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current query metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this query representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown or invalid filter."},"503":{"description":"Full map publication remains closed; sources and gaps stay public."}}}},"/v1/tax-industry/uk/{collection}/{id}":{"get":{"operationId":"getUkTaxIndustryRecord","summary":"Read one evidence-backed UK tax-industry record","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","roles","qualifications","gates","pathways","study","compensation","barriers","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"The record, resolved sources and relevant joined records.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkTaxIndustryResponse"}}}},"304":{"description":"This exact record representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Detail routes do not accept query parameters."},"404":{"description":"No record with that ID in the collection."},"503":{"description":"Full map publication remains closed."}}},"head":{"operationId":"headUkTaxIndustryRecord","summary":"Check one UK tax-industry record","description":"Returns the record's validators and links without its response body.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","roles","qualifications","gates","pathways","study","compensation","barriers","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current record metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this record representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Detail routes do not accept query parameters."},"404":{"description":"No record with that ID in the collection."},"503":{"description":"Full map publication remains closed."}}}},"/v1/tax-industry/uk/graph":{"get":{"operationId":"downloadUkTaxIndustryGraph","summary":"Download the complete reviewed UK tax-industry graph","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"The complete static corpus, including source limitations and gaps.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.uk.tax-industry/1"]},"meta":{"type":"object","properties":{"title":{"type":"string","minLength":1},"version":{"type":"string","minLength":1},"reviewedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","enum":["United Kingdom"]},"coverage":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"exclusions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"editorialRules":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"contentLicence":{"type":"object","properties":{"name":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false},"warning":{"type":"string","minLength":1}},"required":["title","version","reviewedOn","jurisdiction","coverage","exclusions","editorialRules","contentLicence","warning"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"title":{"type":"string","minLength":1},"publisher":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"authorityLevel":{"type":"string","enum":["primary-law","statutory-regulator","official-register","government-guidance","government-careers","professional-body","company-report","public-audit"]},"reviewedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"reviewAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"lastUpdated":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"status":{"type":"string","enum":["current","historical","pending","partly-current"]},"reuseStatus":{"type":"string","enum":["confirmed","link-only","unknown"]},"publicationMode":{"type":"string","enum":["normalised-summary","metadata-only","link-only"]},"supports":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"doesNotProve":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"licence":{"type":["object","null"],"properties":{"name":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"}},"required":["name"],"additionalProperties":false}},"required":["id","title","publisher","url","authorityLevel","reviewedOn","reviewAfter","status","reuseStatus","publicationMode","supports","doesNotProve","licence"],"additionalProperties":false},"minItems":1},"institutions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"kind":{"type":"string","enum":["public-authority","statutory-regulator","professional-body","court","professional-services-firm","training-market","software-platform"]},"legalForm":{"type":"string","minLength":1},"originDate":{"type":["string","null"],"pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"originPeriod":{"type":["string","null"],"minLength":1},"predecessors":{"type":"array","items":{"type":"string","minLength":1}},"origin":{"type":"string","minLength":1},"whyItExists":{"type":"string","minLength":1},"governance":{"type":"string","minLength":1},"fundingModel":{"type":"string","minLength":1},"currentScale":{"type":"array","items":{"type":"string","minLength":1}},"powerAndLimits":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"website":{"type":"string","format":"uri"},"taxSystemRefs":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-fees"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"transparencyNotes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["id","name","kind","legalForm","originDate","originPeriod","predecessors","origin","whyItExists","governance","fundingModel","currentScale","powerAndLimits","website","taxSystemRefs","sourceIds","evidence","transparencyNotes"],"additionalProperties":false},"minItems":1},"roles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"category":{"type":"string","enum":["tax-advice","tax-compliance","accountancy","legal","public-service","insolvency","debt-and-enforcement","software"]},"work":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"legallyReserved":{"type":"array","items":{"type":"string","minLength":1}},"generallyUnreserved":{"type":"array","items":{"type":"string","minLength":1}},"requiredGateIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"conditionalGateIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"commonQualificationIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"protectedTitles":{"type":"array","items":{"type":"string","minLength":1}},"employeeEntry":{"type":"string","minLength":1},"independentEntry":{"type":"string","minLength":1},"riskBoundary":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"pathwayIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"compensationIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"taxSystemRefs":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-fees"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","category","work","legallyReserved","generallyUnreserved","requiredGateIds","conditionalGateIds","commonQualificationIds","protectedTitles","employeeEntry","independentEntry","riskBoundary","pathwayIds","compensationIds","taxSystemRefs","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"qualifications":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"awardingInstitutionIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"status":{"type":"string","enum":["voluntary-designation","professional-membership","statutory-precondition","apprenticeship-standard"]},"level":{"type":"string","minLength":1},"designation":{"type":["string","null"],"minLength":1},"entryRequirements":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"assessments":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"format":{"type":"string","minLength":1},"durationMinutes":{"type":"integer","exclusiveMinimum":0},"passMarkPercent":{"type":"number","minimum":0,"maximum":100},"choice":{"type":"string","minLength":1}},"required":["name","format"],"additionalProperties":false},"minItems":1},"experienceRequirement":{"type":"string","minLength":1},"typicalDuration":{"type":"string","minLength":1},"feeItems":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"amountGbp":{"type":"number","minimum":0},"rangeGbp":{"type":"object","properties":{"low":{"type":"number","minimum":0},"high":{"type":"number","minimum":0}},"required":["low","high"],"additionalProperties":false},"cadence":{"type":"string","enum":["once","per-attempt","annual","per-premises","variable"]},"required":{"type":"boolean"},"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"note":{"type":"string","minLength":1}},"required":["label","cadence","required","asOf","note"],"additionalProperties":false}},"costSummary":{"type":"string","minLength":1},"exemptions":{"type":"string","minLength":1},"membershipAndMaintenance":{"type":"string","minLength":1},"publicRegister":{"type":["string","null"],"format":"uri"},"studyResourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"barrierNotes":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"leastFrictionRoute":{"type":"string","minLength":1},"notEquivalentTo":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-fees"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"volatile":{"type":"boolean"}},"required":["id","name","awardingInstitutionIds","status","level","designation","entryRequirements","assessments","experienceRequirement","typicalDuration","feeItems","costSummary","exemptions","membershipAndMaintenance","publicRegister","studyResourceIds","barrierNotes","leastFrictionRoute","notEquivalentTo","sourceIds","evidence","volatile"],"additionalProperties":false},"minItems":1},"gates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"type":{"type":"string","enum":["business-formation","statutory-registration","aml-supervision","data-protection","client-authority","professional-membership","practising-certificate","platform-access","insurance","court-certificate","regulatory-authorisation","employer-selection"]},"legalStatus":{"type":"string","enum":["mandatory","conditional","voluntary-market-gate"]},"trigger":{"type":"string","minLength":1},"controllerInstitutionIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"steps":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"requirements":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"feeItems":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"amountGbp":{"type":"number","minimum":0},"rangeGbp":{"type":"object","properties":{"low":{"type":"number","minimum":0},"high":{"type":"number","minimum":0}},"required":["low","high"],"additionalProperties":false},"cadence":{"type":"string","enum":["once","per-attempt","annual","per-premises","variable"]},"required":{"type":"boolean"},"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"note":{"type":"string","minLength":1}},"required":["label","cadence","required","asOf","note"],"additionalProperties":false}},"timing":{"type":"string","minLength":1},"renewal":{"type":"string","minLength":1},"publicRegister":{"type":["string","null"],"format":"uri"},"refusalOrBreach":{"type":"string","minLength":1},"notEquivalentTo":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"leastFriction":{"type":"string","minLength":1},"roleIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"qualificationIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"taxSystemRefs":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-fees"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"volatile":{"type":"boolean"}},"required":["id","name","type","legalStatus","trigger","controllerInstitutionIds","steps","requirements","feeItems","timing","renewal","publicRegister","refusalOrBreach","notEquivalentTo","leastFriction","roleIds","qualificationIds","taxSystemRefs","sourceIds","evidence","volatile"],"additionalProperties":false},"minItems":1},"pathways":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"targetRoleIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"outcome":{"type":"string","minLength":1},"startingPoint":{"type":"string","minLength":1},"legalMinimum":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"marketCredibility":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"steps":{"type":"array","items":{"type":"object","properties":{"order":{"type":"integer","exclusiveMinimum":0},"action":{"type":"string","minLength":1},"gateId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"qualificationId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"mandatory":{"type":"boolean"},"why":{"type":"string","minLength":1},"personalCost":{"type":"string","minLength":1},"time":{"type":"string","minLength":1}},"required":["order","action","mandatory","why","personalCost","time"],"additionalProperties":false},"minItems":1},"estimatedTime":{"type":"string","minLength":1},"directCost":{"type":"string","minLength":1},"lowestFriction":{"type":"string","minLength":1},"tradeoffs":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"stopConditions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-fees"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","targetRoleIds","outcome","startingPoint","legalMinimum","marketCredibility","steps","estimatedTime","directCost","lowestFriction","tradeoffs","stopConditions","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"studyResources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"providerInstitutionIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"format":{"type":"string","minLength":1},"access":{"type":"string","enum":["free","paid","mixed","employer-funded"]},"officialStatus":{"type":"string","enum":["exam-body","primary-material","government-guidance","commercial-tuition"]},"qualificationIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"coverage":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"costAndAccess":{"type":"string","minLength":1},"limitations":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"url":{"type":"string","format":"uri"},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-fees"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"volatile":{"type":"boolean"}},"required":["id","name","providerInstitutionIds","format","access","officialStatus","qualificationIds","coverage","costAndAccess","limitations","url","sourceIds","evidence","volatile"],"additionalProperties":false},"minItems":1},"compensation":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"label":{"type":"string","minLength":1},"roleIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"institutionIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"measure":{"type":"string","enum":["salary-range","advertised-apprenticeship-wage","average-distributable-profit-per-partner","fee-income","tax-service-revenue"]},"amountGbp":{"type":"number","minimum":0},"rangeGbp":{"type":"object","properties":{"low":{"type":"number","minimum":0},"high":{"type":"number","minimum":0}},"required":["low","high"],"additionalProperties":false},"period":{"type":"string","enum":["year","financial-year","one-off"]},"geography":{"type":"string","minLength":1},"referencePeriod":{"type":"string","minLength":1},"sourceMethod":{"type":"string","minLength":1},"comparabilityWarning":{"type":"string","minLength":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-fees"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"volatile":{"type":"boolean"}},"required":["id","label","roleIds","institutionIds","measure","period","geography","referencePeriod","sourceMethod","comparabilityWarning","sourceIds","evidence","volatile"],"additionalProperties":false},"minItems":1},"barriers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"type":{"type":"string","enum":["law","regulatory-access","professional-status","employer-convention","cost","experience-loop","platform-access","information-asymmetry","market-concentration"]},"createdByInstitutionIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"gateIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"qualificationIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"mechanism":{"type":"string","minLength":1},"statedRationale":{"type":"string","minLength":1},"burden":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"whoBenefits":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"whoBearsIt":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"lawfulLowFriction":{"type":"string","minLength":1},"countervailingSafeguard":{"type":"string","minLength":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-fees"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","type","createdByInstitutionIds","gateIds","qualificationIds","mechanism","statedRationale","burden","whoBenefits","whoBearsIt","lawfulLowFriction","countervailingSafeguard","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"transparencyGaps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"title":{"type":"string","minLength":1},"detail":{"type":"string","minLength":1},"consequence":{"type":"string","minLength":1},"status":{"type":"string","enum":["open","source-conflict","time-sensitive","bounded-by-design"]},"affectedIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-fees"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","title","detail","consequence","status","affectedIds","sourceIds","evidence"],"additionalProperties":false},"minItems":1}},"required":["schema","meta","sources","institutions","roles","qualifications","gates","pathways","studyResources","compensation","barriers","transparencyGaps"],"additionalProperties":false}}}},"304":{"description":"The supplied ETag still identifies this exact graph.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."},"503":{"description":"Full map publication remains closed."}}},"head":{"operationId":"headUkTaxIndustryGraph","summary":"Check the complete UK tax-industry graph","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."},"503":{"description":"Full map publication remains closed."}}}},"/v1/tax-industry/uk/manifest":{"get":{"operationId":"getUkTaxIndustryManifest","summary":"Read the UK tax-industry release manifest","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Version, review date, deterministic graph-byte SHA-256, counts, licence and distribution links.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkTaxIndustryResponse"}}}},"304":{"description":"This exact manifest is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxIndustryManifest","summary":"Check the UK tax-industry manifest","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-industry/uk/schema":{"get":{"operationId":"getUkTaxIndustrySchema","summary":"Read the structural UK tax-industry JSON Schema","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Structural JSON Schema generated from the Zod record shape; the dictionary lists boot-only graph and cross-field invariants.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/schema+json":{"schema":{"$ref":"#/components/schemas/UkTaxIndustryResponse"}}}},"304":{"description":"This exact schema is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxIndustrySchema","summary":"Check the UK tax-industry structural schema","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-industry/uk/dictionary":{"get":{"operationId":"getUkTaxIndustryDictionary","summary":"Read the plain-language UK tax-industry data dictionary","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Collection aliases, meanings, filters, references, CSV columns and reuse conventions.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataDictionary"}}}},"304":{"description":"This exact dictionary is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxIndustryDictionary","summary":"Check the UK tax-industry dictionary","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-industry/uk/exports":{"get":{"operationId":"listUkTaxIndustryExports","summary":"List complete UK tax-industry collection exports","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Format links, filenames, sizes and exact-byte ETags for every collection.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetExportIndex"}}}},"304":{"description":"This exact export index is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkTaxIndustryExports","summary":"Check the UK tax-industry export index","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/tax-industry/uk/exports/{collection}/{format}":{"get":{"operationId":"downloadUkTaxIndustryCollection","summary":"Download one complete UK tax-industry collection","description":"JSON and NDJSON use lossless TaxSorted deterministic JSON (not RFC 8785/JCS). CSV keeps nested values as deterministic JSON and mitigates common spreadsheet-formula prefixes.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","roles","qualifications","gates","pathways","study","compensation","barriers","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","enum":["json","ndjson","csv"]},"required":true,"name":"format","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Complete, unpaginated collection attachment.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenDataRecord"}}},"application/x-ndjson":{"schema":{"type":"string"}},"text/csv":{"schema":{"type":"string"}}}},"304":{"description":"This exact export format is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"400":{"description":"Static export routes do not accept query parameters."},"404":{"description":"Unknown collection or format."},"503":{"description":"This collection is still inside the publication review boundary."}}},"head":{"operationId":"headUkTaxIndustryCollectionExport","summary":"Check one UK tax-industry collection export","description":"Returns download validators, size-independent links and filename without the export body.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","roles","qualifications","gates","pathways","study","compensation","barriers","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","enum":["json","ndjson","csv"]},"required":true,"name":"format","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current export metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this export.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"400":{"description":"Static export routes do not accept query parameters."},"404":{"description":"Unknown collection or format."},"503":{"description":"This collection is still inside the publication review boundary."}}}},"/v1/charities/uk/map":{"get":{"operationId":"redirectUkCharitiesMap","summary":"Follow the UK charity-sector map alias","description":"Compatibility redirect to the canonical charity-sector overview.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"304":{"description":"The redirect representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"308":{"description":"Permanent redirect to /v1/charities/uk.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Location":{"description":"Canonical route to request instead.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkCharitiesMapRedirect","summary":"Check the UK charity-sector map redirect","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"304":{"description":"The redirect representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"308":{"description":"Permanent redirect metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Location":{"description":"Canonical route to request instead.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/charities/uk/{collection}":{"get":{"operationId":"queryUkCharitiesCollection","summary":"Query the bounded UK charity-sector map","description":"Queries regulators, official register doors, legal forms, conditional tax treatments, obligations, funding mechanisms, finance disclosures, control models, generic help routes, pipeline stages and gaps. Filters are collection-specific; the dictionary is authoritative and unsupported collection/filter pairs return 400. There are no charity-by-charity or people records and no religion or name filter.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","regulators","registers","legal-forms","tax-treatments","obligations","funding","finance","control","help","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"jurisdiction","in":"query"},{"schema":{"type":"string"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"taxType","in":"query"},{"schema":{"type":"string"},"required":false,"name":"obligationType","in":"query"},{"schema":{"type":"string"},"required":false,"name":"fundingType","in":"query"},{"schema":{"type":"string"},"required":false,"name":"helpCategory","in":"query"},{"schema":{"type":"string"},"required":false,"name":"regulatorId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sourceId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Filtered sector records with paging and provenance metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkCharitiesResponse"}}}},"304":{"description":"This exact query representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown, repeated, irrelevant or invalid filter."},"503":{"description":"The full sector release is disabled or emergency-stopped; sources, register doors and gaps remain readable."}}},"head":{"operationId":"headUkCharitiesCollectionQuery","summary":"Check a UK charity-sector collection query","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","regulators","registers","legal-forms","tax-treatments","obligations","funding","finance","control","help","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"jurisdiction","in":"query"},{"schema":{"type":"string"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"taxType","in":"query"},{"schema":{"type":"string"},"required":false,"name":"obligationType","in":"query"},{"schema":{"type":"string"},"required":false,"name":"fundingType","in":"query"},{"schema":{"type":"string"},"required":false,"name":"helpCategory","in":"query"},{"schema":{"type":"string"},"required":false,"name":"regulatorId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sourceId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current query metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"This exact query is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown, repeated, irrelevant or invalid filter."},"503":{"description":"The collection is disabled or emergency-stopped."}}}},"/v1/charities/uk/{collection}/{id}":{"get":{"operationId":"getUkCharitiesRecord","summary":"Read one evidence-backed UK charity-sector record","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","regulators","registers","legal-forms","tax-treatments","obligations","funding","finance","control","help","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"One sector record with its resolved official sources.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkCharitiesResponse"}}}},"304":{"description":"This exact record representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Detail routes do not accept query parameters."},"404":{"description":"No record with that ID in the collection."},"503":{"description":"The collection is disabled or emergency-stopped."}}},"head":{"operationId":"headUkCharitiesRecord","summary":"Check one UK charity-sector record","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","regulators","registers","legal-forms","tax-treatments","obligations","funding","finance","control","help","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current record metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"This exact record is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Detail routes do not accept query parameters."},"404":{"description":"No record with that ID in the collection."},"503":{"description":"The collection is disabled or emergency-stopped."}}}},"/v1/charities/uk":{"get":{"operationId":"getUkCharitiesOverview","summary":"Understand the bounded UK charity-sector API","description":"Public, sessionless route map for conditional relief, regulation, money, control, obligations and safe help discovery. This release contains no charity mirror, named people, personal contacts or inferred beliefs.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkCharitiesResponse"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkCharitiesOverview","summary":"Check: Understand the bounded UK charity-sector API","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/charities/uk/graph":{"get":{"operationId":"downloadUkCharitiesGraph","summary":"Download the complete reviewed UK charity-sector graph","description":"Complete organisation-free sector corpus, including source limitations and known transparency gaps.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.uk.charities/1"]},"meta":{"type":"object","properties":{"title":{"type":"string","minLength":1},"version":{"type":"string","minLength":1},"reviewedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","enum":["United Kingdom"]},"coverage":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"exclusions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"editorialRules":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"contentLicence":{"type":"object","properties":{"name":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false},"warning":{"type":"string","minLength":1}},"required":["title","version","reviewedOn","jurisdiction","coverage","exclusions","editorialRules","contentLicence","warning"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"title":{"type":"string","minLength":1},"publisher":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"authorityLevel":{"type":"string","enum":["primary-law","statutory-regulator","government-guidance","government-data","official-register","tax-authority-guidance","data-protection-regulator"]},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"reviewedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"reviewAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"lastUpdated":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"status":{"type":"string","enum":["current","partly-current","historical","availability-uncertain"]},"reuseStatus":{"type":"string","enum":["confirmed","conditional","link-only","unknown"]},"publicationMode":{"type":"string","enum":["normalised-summary","metadata-only","link-only"]},"licence":{"type":["object","null"],"properties":{"name":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"attribution":{"type":"string","minLength":1}},"required":["name","url"],"additionalProperties":false},"supports":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"doesNotProve":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["id","title","publisher","url","authorityLevel","jurisdictions","reviewedOn","reviewAfter","status","reuseStatus","publicationMode","licence","supports","doesNotProve"],"additionalProperties":false},"minItems":1},"regulators":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"kind":{"type":"string","enum":["charity-regulator","tax-authority","company-registrar","local-rating-authority","data-protection-regulator"]},"role":{"type":"string","minLength":1},"powers":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"limits":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"website":{"type":"string","format":"uri"}},"required":["id","name","jurisdictions","sourceIds","evidence","kind","role","powers","limits","website"],"additionalProperties":false},"minItems":1},"registers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"kind":{"type":"string","enum":["charity-register","company-register","public-grants","public-contracts"]},"regulatorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"accessMode":{"type":"string","enum":["search","bulk-download","download-and-api","export-on-demand"]},"accessUrl":{"type":"string","format":"uri"},"updateCadence":{"type":"string","minLength":1},"stableIdentifiers":{"type":"array","items":{"type":"string","minLength":1}},"availableOrganisationFields":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"excludedOrUnreliable":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"rightsAndConditions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"containsPersonalData":{"type":"boolean"},"ingestionStatus":{"type":"string","enum":["metadata-only","ready-after-review","manual-only","fail-closed"]},"ingestionReason":{"type":"string","minLength":1}},"required":["id","name","jurisdictions","sourceIds","evidence","kind","regulatorIds","accessMode","accessUrl","updateCadence","stableIdentifiers","availableOrganisationFields","excludedOrUnreliable","rightsAndConditions","containsPersonalData","ingestionStatus","ingestionReason"],"additionalProperties":false},"minItems":1},"legalForms":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"incorporated":{"type":"boolean"},"separateLegalPersonality":{"type":"boolean"},"regulatorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"governingDocument":{"type":"string","minLength":1},"governance":{"type":"string","minLength":1},"membership":{"type":"string","minLength":1},"assetHolding":{"type":"string","minLength":1},"ownerModel":{"type":"string","minLength":1},"reportingShape":{"type":"string","minLength":1},"notEquivalentTo":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["id","name","jurisdictions","sourceIds","evidence","incorporated","separateLegalPersonality","regulatorIds","governingDocument","governance","membership","assetHolding","ownerModel","reportingShape","notEquivalentTo"],"additionalProperties":false},"minItems":1},"taxTreatments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"taxType":{"type":"string","enum":["recognition","income-and-gains","trading","gift-aid","vat","business-rates","property-transaction","cross-tax-rationale"]},"position":{"type":"string","enum":["administrative-recognition","conditional-relief","taxable-unless-relief","no-blanket-exemption","taxsorted-analysis"]},"eligibility":{"type":"string","minLength":1},"benefit":{"type":"string","minLength":1},"conditions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"whenTaxOrClawbackCanArise":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"reasoningStatus":{"type":"string","enum":["official-summary","taxsorted-analysis"]},"reasoning":{"type":"string","minLength":1},"notEquivalentTo":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["id","name","jurisdictions","sourceIds","evidence","taxType","position","eligibility","benefit","conditions","whenTaxOrClawbackCanArise","reasoningStatus","reasoning","notEquivalentTo"],"additionalProperties":false},"minItems":1},"obligations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"obligationType":{"type":"string","enum":["charitable-status","registration","annual-reporting","accounts","tax-return","governance","company-filing","data-protection"]},"regulatorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"appliesTo":{"type":"string","minLength":1},"trigger":{"type":"string","minLength":1},"requirement":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"deadline":{"type":"string","minLength":1},"nonCompliance":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"practicalCheck":{"type":"string","minLength":1}},"required":["id","name","jurisdictions","sourceIds","evidence","obligationType","regulatorIds","appliesTo","trigger","requirement","deadline","nonCompliance","practicalCheck"],"additionalProperties":false},"minItems":1},"fundingMechanisms":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"category":{"type":"string","enum":["donation","grant","contract","primary-purpose-trading","non-primary-trading","investment-and-property","fundraising-event"]},"flow":{"type":"string","minLength":1},"taxTreatmentIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"publicEvidence":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"limits":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"safeUse":{"type":"string","minLength":1}},"required":["id","name","jurisdictions","sourceIds","evidence","category","flow","taxTreatmentIds","publicEvidence","limits","safeUse"],"additionalProperties":false},"minItems":1},"financeDisclosures":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"disclosureType":{"type":"string","enum":["income-and-spend","assets-and-liabilities","employee-pay-bands","trustee-remuneration","subsidiaries-and-related-parties","public-funding","filed-accounts"]},"registerIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"coverage":{"type":"string","minLength":1},"whatPublicCanSee":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"interpretation":{"type":"string","minLength":1},"privacyBoundary":{"type":"string","minLength":1}},"required":["id","name","jurisdictions","sourceIds","evidence","disclosureType","registerIds","coverage","whatPublicCanSee","interpretation","privacyBoundary"],"additionalProperties":false},"minItems":1},"controlModels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"modelType":{"type":"string","enum":["trustee-stewardship","incorporated-entity","trust-asset-holding","membership-governance","subsidiary-control","statutory-company-control"]},"legalFormIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"decisionRights":{"type":"string","minLength":1},"assetPosition":{"type":"string","minLength":1},"accountability":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"misleadingLabel":{"type":"string","minLength":1}},"required":["id","name","jurisdictions","sourceIds","evidence","modelType","legalFormIds","decisionRights","assetPosition","accountability","misleadingLabel"],"additionalProperties":false},"minItems":1},"helpRoutes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"helpCategory":{"type":"string","enum":["find-an-organisation","ask-an-organisation","regulatory-help","tax-help","rates-help","funding-due-diligence"]},"registerIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"regulatorIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"serviceUrl":{"type":"string","format":"uri"},"purpose":{"type":"string","minLength":1},"firstStep":{"type":"string","minLength":1},"askFor":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"safeContactRule":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"basis":{"type":"string","enum":["official-process","taxsorted-practical-guidance"]}},"required":["id","name","jurisdictions","sourceIds","evidence","helpCategory","registerIds","regulatorIds","serviceUrl","purpose","firstStep","askFor","safeContactRule","basis"],"additionalProperties":false},"minItems":1},"pipelineStages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"lane":{"type":"string","enum":["source-admission","collection","publication","help-discovery"]},"order":{"type":"integer","minimum":0},"trigger":{"type":"string","minLength":1},"registerIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"action":{"type":"string","minLength":1},"checks":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"output":{"type":"string","minLength":1},"publicationDecision":{"type":"string","enum":["continue","metadata-only","quarantine","publish","stop"]},"nextStageIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}}},"required":["id","name","jurisdictions","sourceIds","evidence","lane","order","trigger","registerIds","action","checks","output","publicationDecision","nextStageIds"],"additionalProperties":false},"minItems":1},"transparencyGaps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","enum":["United Kingdom","England","Wales","England and Wales","Scotland","Northern Ireland"]},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","editorial-analysis","derived-exact-id-mapping"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1},"title":{"type":"string","minLength":1},"detail":{"type":"string","minLength":1},"consequence":{"type":"string","minLength":1},"status":{"type":"string","enum":["open","source-conflict","time-sensitive","bounded-by-design"]},"affectedIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["id","name","jurisdictions","sourceIds","evidence","title","detail","consequence","status","affectedIds"],"additionalProperties":false},"minItems":1}},"required":["schema","meta","sources","regulators","registers","legalForms","taxTreatments","obligations","fundingMechanisms","financeDisclosures","controlModels","helpRoutes","pipelineStages","transparencyGaps"],"additionalProperties":false}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."},"503":{"description":"The full sector release is disabled or emergency-stopped."}}},"head":{"operationId":"headUkCharitiesGraph","summary":"Check: Download the complete reviewed UK charity-sector graph","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."},"503":{"description":"The full sector release is disabled or emergency-stopped."}}}},"/v1/charities/uk/manifest":{"get":{"operationId":"getUkCharitiesManifest","summary":"Read the UK charity-sector release manifest","description":"Version, review date, exact graph hash, counts, licence and distribution links.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkCharitiesResponse"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkCharitiesManifest","summary":"Check: Read the UK charity-sector release manifest","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/charities/uk/schema":{"get":{"operationId":"getUkCharitiesSchema","summary":"Read the structural UK charity-sector JSON Schema","description":"Strict record shapes; the dictionary lists boot-only reference and safety invariants.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/schema+json":{"schema":{"$ref":"#/components/schemas/UkCharitiesResponse"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkCharitiesSchema","summary":"Check: Read the structural UK charity-sector JSON Schema","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/charities/uk/dictionary":{"get":{"operationId":"getUkCharitiesDictionary","summary":"Read the plain-language UK charity-sector data dictionary","description":"Collection aliases, field meanings, filters, references, formats and missing-value rules.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataDictionary"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkCharitiesDictionary","summary":"Check: Read the plain-language UK charity-sector data dictionary","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/charities/uk/exports":{"get":{"operationId":"listUkCharitiesExports","summary":"List complete UK charity-sector collection exports","description":"Format links, filenames, byte sizes and exact-representation ETags.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetExportIndex"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkCharitiesExports","summary":"Check: List complete UK charity-sector collection exports","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/charities/uk/exports/{collection}/{format}":{"get":{"operationId":"downloadUkCharitiesCollection","summary":"Download one complete UK charity-sector collection","description":"JSON and NDJSON are lossless deterministic TaxSorted encodings. CSV is a spreadsheet convenience copy and keeps nested values as deterministic JSON.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","regulators","registers","legal-forms","tax-treatments","obligations","funding","finance","control","help","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","enum":["json","ndjson","csv"]},"required":true,"name":"format","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Complete, unpaginated collection attachment.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenDataRecord"}}},"application/x-ndjson":{"schema":{"type":"string"}},"text/csv":{"schema":{"type":"string"}}}},"304":{"description":"This exact export is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"400":{"description":"Static export routes do not accept query parameters."},"404":{"description":"Unknown collection or format."},"503":{"description":"This collection is disabled or emergency-stopped."}}},"head":{"operationId":"headUkCharitiesCollectionExport","summary":"Check one UK charity-sector collection export","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","regulators","registers","legal-forms","tax-treatments","obligations","funding","finance","control","help","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","enum":["json","ndjson","csv"]},"required":true,"name":"format","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current export metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"304":{"description":"This exact export is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"400":{"description":"Static export routes do not accept query parameters."},"404":{"description":"Unknown collection or format."},"503":{"description":"This collection is disabled or emergency-stopped."}}}},"/v1/public-funding/uk/{collection}":{"get":{"operationId":"queryUkPublicFundingCollection","summary":"Query a UK public-funding collection","description":"Queries the reviewed public-funding map. Filters are collection-specific; unsupported, repeated or invalid filters return 400. Sources and gaps remain readable while the full release is closed.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","governance","offices","relationships","funds","programmes","mechanisms","allocations","contacts","locations","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sector","in":"query"},{"schema":{"type":"string"},"required":false,"name":"jurisdiction","in":"query"},{"schema":{"type":"string"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"fundingRole","in":"query"},{"schema":{"type":"string"},"required":false,"name":"beneficiaryTag","in":"query"},{"schema":{"type":"string"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"institutionId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"governanceUnitId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"officeId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"fundId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"programmeId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"mechanismId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"financialYear","in":"query"},{"schema":{"type":"string"},"required":false,"name":"budgetBoundary","in":"query"},{"schema":{"type":"string"},"required":false,"name":"accountingBasis","in":"query"},{"schema":{"type":"string"},"required":false,"name":"grossOrNet","in":"query"},{"schema":{"type":"string"},"required":false,"name":"priceBasis","in":"query"},{"schema":{"type":"string"},"required":false,"name":"lane","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sourceId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Filtered records with paging and provenance metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingList"}}}},"304":{"description":"This exact query representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown, repeated, irrelevant or invalid filter."},"503":{"description":"The full release is pending review or emergency-stopped; sources and gaps remain readable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingUnavailable"}}}}}},"head":{"operationId":"headUkPublicFundingCollectionQuery","summary":"Check a UK public-funding collection query","description":"Returns the GET query's validators and links without its response body.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","governance","offices","relationships","funds","programmes","mechanisms","allocations","contacts","locations","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sector","in":"query"},{"schema":{"type":"string"},"required":false,"name":"jurisdiction","in":"query"},{"schema":{"type":"string"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"fundingRole","in":"query"},{"schema":{"type":"string"},"required":false,"name":"beneficiaryTag","in":"query"},{"schema":{"type":"string"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"institutionId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"governanceUnitId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"officeId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"fundId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"programmeId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"mechanismId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"financialYear","in":"query"},{"schema":{"type":"string"},"required":false,"name":"budgetBoundary","in":"query"},{"schema":{"type":"string"},"required":false,"name":"accountingBasis","in":"query"},{"schema":{"type":"string"},"required":false,"name":"grossOrNet","in":"query"},{"schema":{"type":"string"},"required":false,"name":"priceBasis","in":"query"},{"schema":{"type":"string"},"required":false,"name":"lane","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sourceId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current query metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"This exact query is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown, repeated, irrelevant or invalid filter."},"503":{"description":"The full public-funding release is pending review or emergency-stopped; sources and gaps remain readable."}}}},"/v1/public-funding/uk/{collection}/{id}":{"get":{"operationId":"getUkPublicFundingRecord","summary":"Read one evidence-backed UK public-funding record","description":"Returns the record. Non-source records also include resolved source evidence and any relevant joined graph records.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","governance","offices","relationships","funds","programmes","mechanisms","allocations","contacts","locations","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"One public-funding record with provenance and relevant joins.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingDetail"}}}},"304":{"description":"This exact record representation is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Detail routes do not accept query parameters."},"404":{"description":"No record with that ID in the collection."},"503":{"description":"The collection is pending review or emergency-stopped.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingUnavailable"}}}}}},"head":{"operationId":"headUkPublicFundingRecord","summary":"Check one UK public-funding record","description":"Returns the record's validators and links without its response body.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","governance","offices","relationships","funds","programmes","mechanisms","allocations","contacts","locations","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current record metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"This exact record is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Detail routes do not accept query parameters."},"404":{"description":"No record with that ID in the collection."},"503":{"description":"The collection is pending review or emergency-stopped."}}}},"/v1/public-funding/uk/changes":{"get":{"operationId":"listUkPublicFundingChanges","summary":"Resume an append-only UK public-funding release feed","description":"Caller-held cursor feed for dataset publication history. The first event honestly establishes the current snapshot; it does not fabricate retrospective per-record changes or government-domain events.","security":[],"parameters":[{"schema":{"type":"string"},"required":false,"name":"after","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Release checkpoints after the supplied opaque cursor.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingChangeFeed"}}}},"304":{"description":"This exact cursor page is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown, repeated or invalid cursor/page parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingActionError"}}}}}},"head":{"operationId":"headUkPublicFundingChanges","summary":"Check a UK public-funding release-feed page","security":[],"parameters":[{"schema":{"type":"string"},"required":false,"name":"after","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current release-feed page metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"This exact cursor page is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Unknown, repeated or invalid cursor/page parameter."}}}},"/v1/public-funding/uk/records/{id}":{"get":{"operationId":"resolveUkPublicFundingRecord","summary":"Resolve a stable UK public-funding ID","description":"Returns the record, its collection and canonical collection URL so callers do not need to guess a record's type. Publication controls follow the resolved collection.","security":[],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Resolved collection and canonical record.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingResolvedRecord"}}}},"304":{"description":"This exact resolved record is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"The resolver does not accept query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingActionError"}}}},"404":{"description":"No record has this stable dataset ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingActionError"}}}},"503":{"description":"The resolved collection is pending review or emergency-stopped.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingUnavailable"}}}}}},"head":{"operationId":"headResolvedUkPublicFundingRecord","summary":"Check one resolved UK public-funding ID","security":[],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current resolved-record metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"This exact resolved record is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"The resolver does not accept query parameters."},"404":{"description":"No record has this stable dataset ID."},"503":{"description":"The resolved collection is pending review or emergency-stopped."}}}},"/v1/public-funding/uk":{"get":{"operationId":"getUkPublicFundingOverview","summary":"Understand how UK public funding moves","description":"Public, sessionless coverage-first map of tax pooling, Parliamentary authority, departmental controls, devolved funding, allocation, commissioning, payment, delivery, accounts and audit. It contains aggregate public records, formal offices and functional contacts, never personal beneficiary records.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingResponse"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkPublicFundingOverview","summary":"Check: Understand how UK public funding moves","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/public-funding/uk/graph":{"get":{"operationId":"downloadUkPublicFundingGraph","summary":"Download the complete reviewed UK public-funding graph","description":"Complete provenance-first corpus, including funding dimensions, negative inference boundaries, source limitations and known transparency gaps.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string","enum":["taxsorted.uk.public-funding/1"]},"meta":{"type":"object","properties":{"title":{"type":"string","minLength":1},"version":{"type":"string","minLength":1},"reviewedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","enum":["United Kingdom"]},"coverage":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"exclusions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"editorialRules":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"contentLicence":{"type":"object","properties":{"name":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false},"warning":{"type":"string","minLength":1}},"required":["title","version","reviewedOn","jurisdiction","coverage","exclusions","editorialRules","contentLicence","warning"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"title":{"type":"string","minLength":1},"publisher":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"authorityLevel":{"type":"string","enum":["primary-law","official-budget","official-estimate","official-accounts","official-statistics","official-policy","official-guidance","official-register","public-audit","parliamentary-scrutiny","independent-fiscal-analysis"]},"reviewedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"reviewAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"lastUpdated":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"status":{"type":"string","enum":["current","historical","pending","partly-current"]},"reuseStatus":{"type":"string","enum":["confirmed","link-only","unknown"]},"publicationMode":{"type":"string","enum":["normalised-summary","metadata-only","link-only"]},"supports":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"doesNotProve":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"licence":{"type":["object","null"],"properties":{"name":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"}},"required":["name"],"additionalProperties":false}},"required":["id","title","publisher","url","authorityLevel","reviewedOn","reviewAfter","status","reuseStatus","publicationMode","supports","doesNotProve","licence"],"additionalProperties":false},"minItems":1},"institutions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"kind":{"type":"string","minLength":1},"sectors":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"jurisdictions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"status":{"type":"string","enum":["active","transitional","historical","planned"]},"fundingRoles":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"purpose":{"type":"string","minLength":1},"legalBasis":{"type":"string","minLength":1},"website":{"type":"string","format":"uri"},"taxSystemRefs":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"transparencyNotes":{"type":"array","items":{"type":"string","minLength":1}},"activeFrom":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"activeTo":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","kind","sectors","jurisdictions","status","fundingRoles","purpose","legalBasis","website","taxSystemRefs","transparencyNotes","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"governanceUnits":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"kind":{"type":"string","enum":["board","committee","panel","directorate","advisory-group"]},"institutionId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"authority":{"type":"string","minLength":1},"purpose":{"type":"string","minLength":1},"powers":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"limits":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"chairOfficeId":{"type":["string","null"],"pattern":"^[a-z0-9][a-z0-9-]*$"},"memberOfficeIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"membershipUrl":{"type":["string","null"],"format":"uri"},"meetingsUrl":{"type":["string","null"],"format":"uri"},"transparencyNotes":{"type":"array","items":{"type":"string","minLength":1}},"activeFrom":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"activeTo":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","kind","institutionId","authority","purpose","powers","limits","chairOfficeId","memberOfficeIds","membershipUrl","meetingsUrl","transparencyNotes","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"offices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"institutionId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"kind":{"type":"string","minLength":1},"responsibility":{"type":"string","minLength":1},"decisionScope":{"type":"string","minLength":1},"constraints":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"appointment":{"type":"string","minLength":1},"accountability":{"type":"string","minLength":1},"governanceUnitIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"currentHolderPublication":{"type":"object","properties":{"mode":{"type":"string","enum":["official-source-link-only"]},"url":{"type":"string","format":"uri"},"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"reason":{"type":"string","minLength":1}},"required":["mode","url","asOf","reason"],"additionalProperties":false},"transparencyNotes":{"type":"array","items":{"type":"string","minLength":1}},"activeFrom":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"activeTo":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","institutionId","kind","responsibility","decisionScope","constraints","appointment","accountability","governanceUnitIds","currentHolderPublication","transparencyNotes","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fromId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"toId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"type":{"type":"string","enum":["part-of","sponsors","appoints","chairs","member-of","governs","oversees","sets-policy-for","collects-revenue","pays-into-pool","authorises-limit","sets-budget-control","issues-cash","adjusts-block-grant","allocates-to","grants","delegates-function","directs-resource-limit","pays","commissions","holds-commissioning-responsibility","leads-commissioning-for","selects-provider-under","contracts-with","sets-payment-method-for","administers-payment","reimburses","pools-under","regulates","audits","scrutinises","reports-actual-spend","reports-to","accounts-to","advises","recommends-to","operates","collects-for","transfers-to","consolidates-accounts-for"]},"explanation":{"type":"string","minLength":1},"doesNotProve":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"validFrom":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"validTo":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","fromId","toId","type","explanation","doesNotProve","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"funds":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"kind":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"operatorInstitutionIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"purpose":{"type":"string","minLength":1},"inflows":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"outflows":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"restrictions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"notEquivalentTo":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","kind","jurisdictions","operatorInstitutionIds","purpose","inflows","outflows","restrictions","notEquivalentTo","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"programmes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"sector":{"type":"string","minLength":1},"jurisdictions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"status":{"type":"string","enum":["active","planned","historical","transitional"]},"purpose":{"type":"string","minLength":1},"populationScope":{"type":"string","minLength":1},"beneficiaryTags":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"leadInstitutionIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"deliveryInstitutionIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"fundingMechanismIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"transparencyNotes":{"type":"array","items":{"type":"string","minLength":1}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","sector","jurisdictions","status","purpose","populationScope","beneficiaryTags","leadInstitutionIds","deliveryInstitutionIds","fundingMechanismIds","transparencyNotes","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"fundingMechanisms":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"kind":{"type":"string","minLength":1},"sectors":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"jurisdictions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"status":{"type":"string","enum":["active","planned","historical","transitional"]},"decisionInstitutionIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"payerInstitutionIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"recipientInstitutionIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"fundIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"programmeIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"allocationMethod":{"type":"string","minLength":1},"conditions":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"explanation":{"type":"string","minLength":1},"doesNotProve":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","kind","sectors","jurisdictions","status","decisionInstitutionIds","payerInstitutionIds","recipientInstitutionIds","fundIds","programmeIds","allocationMethod","conditions","explanation","doesNotProve","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"allocations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string","minLength":1},"fromId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"toId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"programmeIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"fundingMechanismId":{"type":["string","null"],"pattern":"^[a-z0-9][a-z0-9-]*$"},"amountMinor":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negativeAmountExplanation":{"type":"string","minLength":1},"currency":{"type":"string","enum":["GBP"]},"financialYear":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"status":{"type":"string","enum":["forecast","plan","authorised","revised","outturn"]},"budgetBoundary":{"type":"string","minLength":1},"accountingBasis":{"type":"string","enum":["cash","accrual","mixed","not-stated"]},"grossOrNet":{"type":"string","enum":["gross","net","not-stated"]},"priceBasis":{"type":"string","enum":["nominal","real","not-stated"]},"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"containedInAllocationId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"additiveGroup":{"type":"string","minLength":1},"notComparableToIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"traceabilityWarning":{"type":"string","minLength":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","name","fromId","toId","programmeIds","fundingMechanismId","amountMinor","currency","financialYear","status","budgetBoundary","accountingBasis","grossOrNet","priceBasis","asOf","traceabilityWarning","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"contacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"institutionIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"governanceUnitIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"officeIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"label":{"type":"string","minLength":1},"kind":{"type":"string","enum":["contact-page","web-form","email","phone","postal-address"]},"value":{"type":"string","minLength":1},"purpose":{"type":"string","minLength":1},"functionalOnly":{"type":"boolean","enum":[true]},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","institutionIds","governanceUnitIds","officeIds","label","kind","value","purpose","functionalOnly","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"officeLocations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"institutionIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"governanceUnitIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"officeIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"label":{"type":"string","minLength":1},"kind":{"type":"string","enum":["headquarters","public-office","correspondence-address","committee-venue","service-location"]},"addressLines":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"locality":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"country":{"type":"string","minLength":1},"publicAccess":{"type":"string","enum":["public","appointment","restricted","not-stated"]},"note":{"type":"string","minLength":1},"residential":{"type":"boolean","enum":[false]},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","institutionIds","governanceUnitIds","officeIds","label","kind","addressLines","locality","country","publicAccess","note","residential","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"pipelineStages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"lane":{"type":"string","minLength":1},"order":{"type":"integer","minimum":0},"name":{"type":"string","minLength":1},"trigger":{"type":"string","minLength":1},"responsibleInstitutionIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"otherNodeIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"fundIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"programmeIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"fundingMechanismIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"input":{"type":"string","minLength":1},"output":{"type":"string","minLength":1},"explanation":{"type":"string","minLength":1},"limits":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"nextStageIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","lane","order","name","trigger","responsibleInstitutionIds","otherNodeIds","fundIds","programmeIds","fundingMechanismIds","input","output","explanation","limits","nextStageIds","sourceIds","evidence"],"additionalProperties":false},"minItems":1},"transparencyGaps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"title":{"type":"string","minLength":1},"detail":{"type":"string","minLength":1},"consequence":{"type":"string","minLength":1},"status":{"type":"string","enum":["open","source-conflict","time-sensitive","bounded-by-design"]},"affectedIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"sourceIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"evidence":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"fields":{"type":"array","items":{"type":"string","pattern":"^\\/"},"minItems":1},"locator":{"type":"string","minLength":1},"observedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"method":{"type":"string","enum":["manual-review","derived-join","calculated-from-published-figures"]}},"required":["sourceId","fields","locator","observedOn","method"],"additionalProperties":false},"minItems":1}},"required":["id","title","detail","consequence","status","affectedIds","sourceIds","evidence"],"additionalProperties":false},"minItems":1}},"required":["schema","meta","sources","institutions","governanceUnits","offices","relationships","funds","programmes","fundingMechanisms","allocations","contacts","officeLocations","pipelineStages","transparencyGaps"],"additionalProperties":false}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."},"503":{"description":"The graph is pending review or emergency-stopped.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingUnavailable"}}}}}},"head":{"operationId":"headUkPublicFundingGraph","summary":"Check: Download the complete reviewed UK public-funding graph","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."},"503":{"description":"The graph is pending review or emergency-stopped."}}}},"/v1/public-funding/uk/manifest":{"get":{"operationId":"getUkPublicFundingManifest","summary":"Read the UK public-funding release manifest","description":"Version, review date, exact graph hash, collection counts, publication state, licence and distribution links.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingResponse"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkPublicFundingManifest","summary":"Check: Read the UK public-funding release manifest","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/public-funding/uk/schema":{"get":{"operationId":"getUkPublicFundingSchema","summary":"Read the structural UK public-funding JSON Schema","description":"Strict record shapes; the dictionary adds graph, evidence, money-comparison and safety invariants checked at boot.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/schema+json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingResponse"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkPublicFundingSchema","summary":"Check: Read the structural UK public-funding JSON Schema","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/public-funding/uk/dictionary":{"get":{"operationId":"getUkPublicFundingDictionary","summary":"Read the plain-language UK public-funding data dictionary","description":"Collection aliases, field meanings, filters, references, money conventions, formats and missing-value rules.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataDictionary"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkPublicFundingDictionary","summary":"Check: Read the plain-language UK public-funding data dictionary","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/public-funding/uk/exports":{"get":{"operationId":"listUkPublicFundingExports","summary":"List complete UK public-funding collection exports","description":"Format links, filenames, byte sizes, availability and exact-representation ETags.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current reviewed static representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetExportIndex"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}},"head":{"operationId":"headUkPublicFundingExports","summary":"Check: List complete UK public-funding collection exports","description":"Returns the same validators and links as GET without a response body.","security":[],"parameters":[{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}}}},"400":{"description":"Static routes do not accept query parameters."}}}},"/v1/public-funding/uk/exports/{collection}/{format}":{"get":{"operationId":"downloadUkPublicFundingCollection","summary":"Download one complete UK public-funding collection","description":"JSON and NDJSON are lossless deterministic TaxSorted encodings. CSV is a spreadsheet convenience copy and keeps nested values as deterministic JSON.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","governance","offices","relationships","funds","programmes","mechanisms","allocations","contacts","locations","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","enum":["json","ndjson","csv"]},"required":true,"name":"format","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Complete, unpaginated collection attachment.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenDataRecord"}}},"application/x-ndjson":{"schema":{"type":"string"}},"text/csv":{"schema":{"type":"string"}}}},"304":{"description":"This exact export is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"400":{"description":"Static export routes do not accept query parameters."},"404":{"description":"Unknown collection or format."},"503":{"description":"This collection is pending review or emergency-stopped.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPublicFundingUnavailable"}}}}}},"head":{"operationId":"headUkPublicFundingCollectionExport","summary":"Check one UK public-funding collection export","description":"Returns download validators, links and filename without the export body.","security":[],"parameters":[{"schema":{"type":"string","enum":["sources","institutions","governance","offices","relationships","funds","programmes","mechanisms","allocations","contacts","locations","pipeline","gaps"]},"required":true,"name":"collection","in":"path"},{"schema":{"type":"string","enum":["json","ndjson","csv"]},"required":true,"name":"format","in":"path"},{"schema":{"type":"string","description":"Validator from a previous response for this same URL and format."},"required":false,"description":"Validator from a previous response for this same URL and format.","name":"If-None-Match","in":"header"}],"responses":{"200":{"description":"Current export metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"304":{"description":"This exact export is unchanged.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Location of this representation; follow Link rel=canonical when it is an alias.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Content-Disposition":{"description":"Versioned download filename.","schema":{"type":"string"}}}},"400":{"description":"Static export routes do not accept query parameters."},"404":{"description":"Unknown collection or format."},"503":{"description":"This collection is pending review or emergency-stopped."}}}},"/v1/politics/uk":{"get":{"summary":"Discover the open UK politics API","description":"Public, sessionless entry point for political-system, public-integrity and reusable bulk datasets. No API key is required.","security":[],"responses":{"200":{"description":"Access policy and links to the dataset catalogue, manifest, sources and OpenAPI document.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"304":{"description":"The supplied ETag still identifies the current representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}}}}},"head":{"summary":"Check UK politics API discovery metadata","description":"Returns the same validators and metadata as GET, without a response body.","security":[],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}}}}}},"/v1/politics/uk/datasets":{"get":{"summary":"List reusable UK politics datasets","description":"Stable dataset IDs, fields, record counts, source IDs, reuse notes, update cadence and JSON/CSV/NDJSON download links.","security":[],"responses":{"200":{"description":"The deterministic open dataset catalogue.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsDatasetCatalogue"}}}},"304":{"description":"The supplied ETag still identifies the current catalogue.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}}}},"head":{"summary":"Check the UK politics dataset catalogue","description":"Returns the same validators and metadata as GET, without a response body.","security":[],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}}}}},"/v1/politics/uk/manifest":{"get":{"summary":"Read the UK politics dataset manifest","description":"Compatibility alias for the canonical /v1/politics/uk/datasets catalogue.","security":[],"responses":{"200":{"description":"The deterministic open dataset catalogue.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsDatasetCatalogue"}}}},"304":{"description":"The supplied ETag still identifies the current catalogue.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}}}},"head":{"summary":"Check the UK politics dataset manifest","description":"Returns the same validators and metadata as GET, without a response body.","security":[],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}}}}},"/v1/politics/uk/datasets/schema":{"get":{"summary":"Read the shared catalogue and dataset-envelope JSON Schema","security":[],"responses":{"200":{"description":"JSON Schema for the catalogue and TaxSorted open-dataset envelope.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}},"content":{"application/schema+json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"304":{"description":"The supplied ETag still identifies the schema.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}}}}},"head":{"summary":"Check the shared open-data schema","description":"Returns the same validators and metadata as GET, without a response body.","security":[],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}}}}}},"/v1/politics/uk/datasets/rights":{"get":{"summary":"Read the mixed-rights and reuse boundary","description":"Explains which TaxSorted-written layers use CC BY-SA 4.0 and why linked source material keeps source-specific terms.","security":[],"responses":{"200":{"description":"Machine-readable curation and source-rights boundary.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"304":{"description":"The supplied ETag still identifies the rights statement.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}}}}},"head":{"summary":"Check the mixed-rights statement","description":"Returns the same validators and metadata as GET, without a response body.","security":[],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}}}}}}},"/v1/politics/uk/datasets/admissions":{"get":{"summary":"Read every dataset admission record and pending human decision","description":"Publishes the purpose, coverage limit, field contract, rights decision, foreseeable risks and mitigations recorded for each bulk dataset.","security":[],"responses":{"200":{"description":"Machine-readable admission ledger; human approval remains pending.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"304":{"description":"The supplied ETag still identifies the admission ledger.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}}}},"head":{"summary":"Check the dataset admission ledger","description":"Returns the same validators and metadata as GET, without a response body.","security":[],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}}}}},"/v1/politics/uk/datasets/{datasetId}":{"get":{"summary":"Read one complete dataset screened for public distribution","security":[],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]+$","example":"enforcement-institutions"},"required":true,"name":"datasetId","in":"path"}],"responses":{"200":{"description":"Dataset descriptor, stable records and distribution links.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsDatasetEnvelope"}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}},"404":{"description":"No screened static dataset has that ID."},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}},"head":{"summary":"Check one UK politics dataset","description":"Returns the same validators and metadata as GET, without a response body.","security":[],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]+$","example":"enforcement-institutions"},"required":true,"name":"datasetId","in":"path"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}},"404":{"description":"No screened static dataset has that ID."}}}},"/v1/politics/uk/datasets/{datasetId}/schema":{"get":{"summary":"Read a dataset's record JSON Schema","security":[],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]+$","example":"enforcement-institutions"},"required":true,"name":"datasetId","in":"path"}],"responses":{"200":{"description":"JSON Schema and the stable field contract for one record.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}},"content":{"application/schema+json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"304":{"description":"The supplied ETag still identifies the schema.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}},"404":{"description":"No screened static dataset has that ID."}}},"head":{"summary":"Check one dataset record schema","description":"Returns the same validators and metadata as GET, without a response body.","security":[],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]+$","example":"enforcement-institutions"},"required":true,"name":"datasetId","in":"path"}],"responses":{"200":{"description":"Current representation metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}},"304":{"description":"The supplied ETag still identifies this representation.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}}}},"404":{"description":"No screened static dataset has that ID."}}}},"/v1/politics/uk/datasets/{datasetId}/download":{"get":{"summary":"Download a complete UK politics dataset","description":"JSON is a self-describing envelope; CSV uses the catalogue field order and canonical JSON for nested cells; NDJSON contains one canonical record per line.","security":[],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]+$","example":"enforcement-institutions"},"required":true,"name":"datasetId","in":"path"},{"schema":{"type":"string","enum":["json","csv","ndjson"]},"required":true,"name":"format","in":"query"}],"responses":{"200":{"description":"A deterministic attachment with representation-specific ETag and checksum headers.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}},"Content-Disposition":{"description":"Safe, version-named attachment filename.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsDatasetEnvelope"}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies the requested format.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}},"Content-Disposition":{"description":"Safe, version-named attachment filename.","schema":{"type":"string"}}}},"400":{"description":"Choose exactly one supported format."},"404":{"description":"No screened static dataset has that ID."},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}},"head":{"summary":"Check one downloadable UK politics representation","description":"Returns the attachment metadata and exact-format validator without a response body.","security":[],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]+$","example":"enforcement-institutions"},"required":true,"name":"datasetId","in":"path"},{"schema":{"type":"string","enum":["json","csv","ndjson"]},"required":true,"name":"format","in":"query"}],"responses":{"200":{"description":"Current attachment metadata.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}},"Content-Disposition":{"description":"Safe, version-named attachment filename.","schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still identifies this format.","headers":{"ETag":{"description":"Strong validator for the exact response representation.","schema":{"type":"string"}},"Cache-Control":{"description":"Public cache policy with bounded revalidation.","schema":{"type":"string"}},"Link":{"description":"Canonical, licence, schema and alternate representation links.","schema":{"type":"string"}},"Content-Location":{"description":"Canonical location represented by this response.","schema":{"type":"string"}},"X-Corpus-Version":{"description":"Reviewed tax-corpus version when the response belongs to a tax graph.","schema":{"type":"string"}},"X-Corpus-Reviewed-On":{"description":"Tax-corpus review date when the response belongs to a tax graph.","schema":{"type":"string"}},"Last-Modified":{"description":"Snapshot date used by the static representation.","schema":{"type":"string"}},"X-Checksum-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the exact response bytes.","schema":{"type":"string"}},"X-Dataset-Id":{"description":"Stable dataset or catalogue identifier.","schema":{"type":"string"}},"X-Dataset-Version":{"description":"Content-derived version of the current dataset or catalogue.","schema":{"type":"string"}},"X-Schema-Version":{"description":"Semantic schema version for this dataset.","schema":{"type":"string"}},"X-Record-Count":{"description":"Number of complete records in the representation.","schema":{"type":"integer","minimum":0}},"Content-Disposition":{"description":"Safe, version-named attachment filename.","schema":{"type":"string"}}}},"400":{"description":"Choose exactly one supported format."},"404":{"description":"No screened static dataset has that ID."},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/relationships/contracts":{"get":{"summary":"Query public contract awards with verified supplier disclosure","description":"Queries a bounded Contracts Finder award window. Direct contacts and addresses are removed, and supplier names require a verified public organisation identifier.","security":[],"parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"required":true,"name":"from","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"required":true,"name":"to","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":20},"required":false,"name":"take","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2000},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"A page of source-linked awards; supplier names require a verified public organisation identifier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"422":{"description":"Invalid dates, span, page size or cursor."},"502":{"description":"The named official source failed or changed shape."},"504":{"description":"The named official source timed out."}}}},"/v1/politics/uk/enforcement/forces":{"get":{"summary":"List police-force institutions from data.police.uk","description":"Returns institutional force IDs and names, not an officer roster.","security":[],"responses":{"200":{"description":"The current institution directory and its stated territorial gaps.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"502":{"description":"The named official source failed or changed shape."},"504":{"description":"The named official source timed out."}}}},"/v1/politics/uk/system":{"get":{"summary":"Read the non-personal UK political-system map","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/elections/process":{"get":{"summary":"Read the UK Parliamentary election process","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/funding/rules":{"get":{"summary":"Read effective-dated campaign-finance rules","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/funding/public":{"get":{"summary":"Read public political-funding schemes","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/power/method":{"get":{"summary":"Read the political office-power method","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/power/offices":{"get":{"summary":"List political office-power cards","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/budgets/accountability":{"get":{"summary":"Read public-money accountability lanes","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/relationships/method":{"get":{"summary":"Read the relationship-evidence method","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/relationships/schema":{"get":{"summary":"Read the evidence-event schema","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/relationships/datasets":{"get":{"summary":"Read finance-source publication states","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/method":{"get":{"summary":"Read the enforcement evidence method","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/institutions":{"get":{"summary":"List enforcement and oversight institutions","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/governance":{"get":{"summary":"Read enforcement governance relationships","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/ranks":{"get":{"summary":"Read generic police rank families","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/pay-benefits":{"get":{"summary":"Read police pay and benefit evidence","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/workforce":{"get":{"summary":"Read aggregate workforce source coverage","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/funding":{"get":{"summary":"Read enforcement funding source coverage","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/vacancies":{"get":{"summary":"Read official enforcement recruitment routes","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/activities":{"get":{"summary":"Read safe institutional activity coverage","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/private-security":{"get":{"summary":"Read the private-security boundary","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/power/method":{"get":{"summary":"Read the enforcement office-power method","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/power/offices":{"get":{"summary":"List enforcement office-power cards","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/enforcement/communication-method":{"get":{"summary":"Read the official-language analysis method","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/integrity":{"get":{"summary":"Read the public-integrity scope and publication state","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/integrity/sources":{"get":{"summary":"Read the public-integrity source registry","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/integrity/corrections":{"get":{"summary":"Read the correction and restriction method","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/history/method":{"get":{"summary":"Read the effective-dated political-history method","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/law/watch":{"get":{"summary":"Read proposed political-system legislation","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/sources":{"get":{"summary":"Read politics coverage, sources, licences and gaps","security":[],"responses":{"200":{"description":"Source-linked public reference data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"503":{"description":"Bulk publication is awaiting approval or has been emergency-stopped."}}}},"/v1/politics/uk/power/offices/{officeId}":{"get":{"summary":"Read one political office-power card","security":[],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"required":true,"name":"officeId","in":"path"}],"responses":{"200":{"description":"Source-linked public response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"404":{"description":"No matching public record."},"503":{"description":"A named-data or bulk-data safety gate is closed."}}}},"/v1/politics/uk/enforcement/institutions/{institutionId}":{"get":{"summary":"Read one enforcement institution","security":[],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"required":true,"name":"institutionId","in":"path"}],"responses":{"200":{"description":"Source-linked public response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"404":{"description":"No matching public record."},"503":{"description":"A named-data or bulk-data safety gate is closed."}}}},"/v1/politics/uk/enforcement/power/offices/{officeId}":{"get":{"summary":"Read one enforcement office-power card","security":[],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"required":true,"name":"officeId","in":"path"}],"responses":{"200":{"description":"Source-linked public response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"404":{"description":"No matching public record."},"503":{"description":"A named-data or bulk-data safety gate is closed."}}}},"/v1/politics/uk/enforcement/forces/{forceId}":{"get":{"summary":"Read one police-force institution","security":[],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"required":true,"name":"forceId","in":"path"}],"responses":{"200":{"description":"Source-linked public response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"404":{"description":"No matching public record."},"503":{"description":"A named-data or bulk-data safety gate is closed."}}}},"/v1/politics/uk/enforcement/forces/{forceId}/leaders":{"get":{"summary":"Read separately gated force-published senior officers","security":[],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"required":true,"name":"forceId","in":"path"}],"responses":{"200":{"description":"Source-linked public response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"404":{"description":"No matching public record."},"503":{"description":"A named-data or bulk-data safety gate is closed."}}}},"/v1/politics/uk/people":{"get":{"summary":"Search current Parliament people when the publication gate is open","security":[],"parameters":[{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","enum":["all","commons","lords"]},"required":false,"name":"house","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0},"required":false,"name":"partyId","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":10000},"required":false,"name":"skip","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":20},"required":false,"name":"take","in":"query"}],"responses":{"200":{"description":"A bounded page of current members.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"422":{"description":"Invalid query."},"503":{"description":"The current-person publication gate is closed."}}}},"/v1/politics/uk/people/{id}":{"get":{"summary":"Read one current Parliament person when the publication gate is open","security":[],"parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100000},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"One current member and purpose-bound public records.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"404":{"description":"The person was not found or is not current."},"503":{"description":"The current-person publication gate is closed."}}}},"/v1/politics/uk/parties":{"get":{"summary":"List active Parliamentary parties","security":[],"parameters":[{"schema":{"type":"string","enum":["all","commons","lords"]},"required":false,"name":"house","in":"query"}],"responses":{"200":{"description":"Active parties by selected House.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"422":{"description":"Invalid House."},"503":{"description":"The current politics publication gate is closed."}}}},"/v1/politics/uk/roles":{"get":{"summary":"List current government or opposition posts","security":[],"parameters":[{"schema":{"type":"string","enum":["government","opposition"]},"required":true,"name":"kind","in":"query"}],"responses":{"200":{"description":"Current posts and holders.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"422":{"description":"Invalid role kind."},"503":{"description":"The current-person publication gate is closed."}}}},"/v1/politics/uk/funding/donations":{"get":{"summary":"Query verified-company political donations when both gates are open","security":[],"parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"required":true,"name":"from","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"required":true,"name":"to","in":"query"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"recipient","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":100000},"required":false,"name":"skip","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"take","in":"query"}],"responses":{"200":{"description":"A bounded company-only donation page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"422":{"description":"Invalid dates or pagination."},"503":{"description":"Reuse confirmation or privacy review is not complete."}}}},"/v1/politics/uk/relationships/ministerial-benefits":{"get":{"summary":"Query monthly ministerial gifts and hospitality when its gate is open","security":[],"parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"required":true,"name":"month","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":100},"required":true,"name":"department","in":"query"},{"schema":{"type":"string","enum":["all","gift","hospitality"]},"required":false,"name":"type","in":"query"}],"responses":{"200":{"description":"Source-reported monthly records without name-based joining.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPoliticsOpenDataResponse"}}}},"404":{"description":"No matching published attachment."},"422":{"description":"Invalid month, department or record type."},"503":{"description":"The ministerial-benefits publication gate is closed."}}}},"/v1/uk/sdlt/calculations":{"post":{"operationId":"calculateResidentialSdlt","summary":"Calculate one ordinary residential SDLT transaction","description":"Deterministic, source-backed SDLT calculation for one residential dwelling in England or Northern Ireland. Recognised cases outside the bounded scope return needs_review without a tax figure.","tags":["SDLT"],"security":[{"WorkspaceKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SdltCalculationRequest"}}}},"responses":{"200":{"description":"A calculated result, or an explicit needs-review outcome.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/SdltCalculatedResponse"},{"$ref":"#/components/schemas/SdltNeedsReviewResponse"}],"discriminator":{"propertyName":"status","mapping":{"calculated":"#/components/schemas/SdltCalculatedResponse","needs_review":"#/components/schemas/SdltNeedsReviewResponse"}}}}}},"400":{"description":"The request body is not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"The workspace key is missing, malformed, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"The workspace key lacks the sdlt:calculate scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The request body is larger than 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"The request body is not application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"The JSON shape is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"An unexpected server error. Request facts are never echoed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"webhooks":{}}