{"openapi":"3.1.0","info":{"title":"fed_salt API","version":"v1","description":"U.S. federal, state, and local tax rates and paradigms. Every value carries a verbatim citation to a primary .gov source, returned inline so any figure is auditable in one step.","contact":{"name":"fed_salt"}},"servers":[{"url":"/","description":"This deployment"}],"paths":{"/api/v1":{"get":{"summary":"Service index","operationId":"getIndex","responses":{"200":{"description":"Available endpoints","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["name","description","version","endpoints"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"version":{"type":"string"},"endpoints":{"type":"array","items":{"type":"object","required":["method","path","purpose"],"properties":{"method":{"type":"string"},"path":{"type":"string"},"purpose":{"type":"string"}}}}}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}}}}},"/api/v1/catalog":{"get":{"summary":"Full catalog","operationId":"getCatalog","responses":{"200":{"description":"All jurisdictions with all facts and citations","headers":{"etag":{"schema":{"type":"string"},"description":"Catalog ETag for conditional GET"},"last-modified":{"schema":{"type":"string"},"description":"RFC 7231 date of last catalog update"},"vary":{"schema":{"type":"string"},"description":"Always 'Accept'"},"x-request-id":{"schema":{"type":"string"},"description":"Echoed or generated request trace ID"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["count","jurisdictions"],"properties":{"count":{"type":"integer"},"jurisdictions":{"type":"array","items":{"$ref":"#/components/schemas/JurisdictionDetail"}}}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"304":{"description":"Not Modified. ETag matched; no body returned."}}}},"/api/v1/jurisdictions":{"get":{"summary":"List jurisdictions","operationId":"listJurisdictions","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["no-tax","rate","deduction","surcharge","carryforward","carryback","character","conformity","threshold","muni-instate","muni-outstate","treasury","agency-obligations","fhlb-ffcb","dividend-qualified","qoz-conformity","qsbs-conformity","migration-loss-conformity","estate-rate","estate-exemption","inheritance-rate","estate-none","community-property","marital-elective-cp","marital-udcprda","trust-nexus","filing-status-flat","filing-status-doubled","filing-status-identical","filing-status-partial","recapture-rate","charitable-agi-limit","charitable-carryforward","estate-exemption-sunset","section-291-rate","qsbs-exclusion-cap","qsbs-gross-asset-ceiling","qsbs-hold-years","corporate-rate","ptet-available","ptet-rate","ptet-credit-mechanism","depreciation","salt-deduction-cap","gift-annual-exclusion"]},"description":"Filter to jurisdictions that have at least one fact of this category. Returns JurisdictionDetail shape when set; JurisdictionSummary when absent."},{"name":"confidence","in":"query","required":false,"schema":{"type":"string","enum":["high","medium","low"]},"description":"Minimum confidence level. A fact is included only if every citation meets this threshold. Combinable with ?category=."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":500},"description":"Maximum jurisdictions to return. Default 500 (all)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0},"description":"Zero-based starting index for pagination."}],"responses":{"200":{"description":"Paginated jurisdiction list with total count","headers":{"etag":{"schema":{"type":"string"},"description":"Catalog ETag for conditional GET"},"last-modified":{"schema":{"type":"string"},"description":"RFC 7231 date of last catalog update"},"vary":{"schema":{"type":"string"},"description":"Always 'Accept'"},"x-request-id":{"schema":{"type":"string"},"description":"Echoed or generated request trace ID"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["total","count","offset","limit","jurisdictions"],"properties":{"total":{"type":"integer","description":"Total matching jurisdictions before pagination."},"count":{"type":"integer","description":"Number of jurisdictions in this page."},"offset":{"type":"integer"},"limit":{"type":"integer"},"jurisdictions":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/JurisdictionSummary"},{"$ref":"#/components/schemas/JurisdictionDetail"}],"description":"JurisdictionSummary when no filter; JurisdictionDetail when ?category= or ?confidence= is set."}}}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"304":{"description":"Not Modified. ETag matched; no body returned."},"400":{"description":"Unknown category, confidence, or invalid pagination value","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/facts":{"get":{"summary":"Flat paginated fact list","operationId":"listFacts","description":"Returns a flat list of facts across all jurisdictions with pagination. Preferred over /catalog for streaming or filtered access.","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["no-tax","rate","deduction","surcharge","carryforward","carryback","character","conformity","threshold","muni-instate","muni-outstate","treasury","agency-obligations","fhlb-ffcb","dividend-qualified","qoz-conformity","qsbs-conformity","migration-loss-conformity","estate-rate","estate-exemption","inheritance-rate","estate-none","community-property","marital-elective-cp","marital-udcprda","trust-nexus","filing-status-flat","filing-status-doubled","filing-status-identical","filing-status-partial","recapture-rate","charitable-agi-limit","charitable-carryforward","estate-exemption-sunset","section-291-rate","qsbs-exclusion-cap","qsbs-gross-asset-ceiling","qsbs-hold-years","corporate-rate","ptet-available","ptet-rate","ptet-credit-mechanism","depreciation","salt-deduction-cap","gift-annual-exclusion"]},"description":"Filter to facts of this category."},{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string"},"description":"Filter to facts for this jurisdiction code (case-insensitive)."},{"name":"confidence","in":"query","required":false,"schema":{"type":"string","enum":["high","medium","low"]},"description":"Minimum confidence level for included facts."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":100},"description":"Maximum facts to return per page. Default 100."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0},"description":"Zero-based starting index for pagination."}],"responses":{"200":{"description":"Paginated flat fact list","headers":{"etag":{"schema":{"type":"string"},"description":"Catalog ETag for conditional GET"},"last-modified":{"schema":{"type":"string"},"description":"RFC 7231 date of last catalog update"},"vary":{"schema":{"type":"string"},"description":"Always 'Accept'"},"x-request-id":{"schema":{"type":"string"},"description":"Echoed or generated request trace ID"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["total","count","offset","limit","facts"],"properties":{"total":{"type":"integer","description":"Total matching facts before pagination."},"count":{"type":"integer","description":"Number of facts in this page."},"offset":{"type":"integer"},"limit":{"type":"integer"},"facts":{"type":"array","items":{"$ref":"#/components/schemas/Fact"}}}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"304":{"description":"Not Modified. ETag matched; no body returned."},"400":{"description":"Invalid filter or pagination parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/openapi":{"get":{"summary":"OpenAPI 3.1 spec","operationId":"getOpenApi","description":"Returns the OpenAPI 3.1 specification for this API as application/json.","responses":{"200":{"description":"The OpenAPI specification document","content":{"application/json":{"schema":{"type":"object"}}}},"304":{"description":"Not Modified. ETag matched; no body returned."}}}},"/api/v1/health":{"get":{"summary":"Readiness probe","operationId":"getHealth","description":"Returns 200 when the catalog is loaded and ready. Includes catalog integrity metrics. Not cached.","responses":{"200":{"description":"Service is healthy","headers":{"etag":{"schema":{"type":"string"},"description":"Catalog ETag for conditional requests"},"last-modified":{"schema":{"type":"string"},"description":"RFC 7231 date of last catalog update"},"vary":{"schema":{"type":"string"},"description":"Always 'Accept'"},"x-request-id":{"schema":{"type":"string"},"description":"Echoed or generated request trace ID"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["status","jurisdictions","facts","sealedFacts","overdueReviews","surveillancePending","catalogAsOf"],"properties":{"status":{"type":"string","enum":["ok"]},"jurisdictions":{"type":"integer"},"facts":{"type":"integer","description":"Total facts across all jurisdictions."},"sealedFacts":{"type":"integer","description":"Facts with a non-null terminalDate (immutable historical records)."},"overdueReviews":{"type":"integer","description":"Facts whose nextReviewDate is in the past. Non-zero means re-verification is due. Alert if > 0."},"surveillancePending":{"type":"integer","description":"Active surveillance items: proposed legislation, pending CPI updates, and unverified guidance not yet encoded as facts."},"catalogAsOf":{"type":"string","format":"date","description":"ISO date of the most recent catalog update."}}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}}}}},"/api/v1/surveillance":{"get":{"summary":"Surveillance watch list","operationId":"getSurveillance","description":"Upcoming catalog changes that are not yet confirmed or effective: proposed legislation, pending CPI adjustments, sunsets, and expected guidance. Items with status 'enacted' are excluded by default (they are already encoded as facts).","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["proposed","passed","enacted"]},"description":"Filter by lifecycle status. Omit to get all active (not enacted) items."},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["legislation","cpi-update","sunset","guidance"]},"description":"Filter by trigger kind."},{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by jurisdiction code (e.g. WA, CT)."}],"responses":{"200":{"description":"Surveillance items","content":{"application/json":{"schema":{"type":"object","required":["total","count","items"],"properties":{"total":{"type":"integer","description":"Count of all active (not enacted) items regardless of filters applied."},"count":{"type":"integer","description":"Count of items returned after filters."},"items":{"type":"array","items":{"type":"object","required":["id","addedAt","jurisdiction","category","kind","status","summary","expectedDate","confidence"],"properties":{"id":{"type":"string"},"addedAt":{"type":"string","format":"date"},"jurisdiction":{"type":"string"},"category":{"type":["string","null"]},"kind":{"type":"string","enum":["legislation","cpi-update","sunset","guidance"]},"status":{"type":"string","enum":["proposed","passed","enacted"]},"summary":{"type":"string"},"ref":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"},"expectedDate":{"type":["string","null"],"format":"date"},"confidence":{"type":"string","enum":["high","medium","low"]},"note":{"type":"string"}}}}}}}}}}}},"/api/v1/citations/{id}":{"get":{"summary":"Citation by ID","operationId":"getCitation","description":"Resolve a single citation by its stable slug ID. Makes citation IDs resolvable URIs so any figure's provenance is directly linkable.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Stable citation slug.","example":"wa-excise-base-rate-7pct"}],"responses":{"200":{"description":"The citation with its full verbatim provenance","headers":{"etag":{"schema":{"type":"string"},"description":"Catalog ETag for conditional GET"},"last-modified":{"schema":{"type":"string"},"description":"RFC 7231 date of last catalog update"},"vary":{"schema":{"type":"string"},"description":"Always 'Accept'"},"x-request-id":{"schema":{"type":"string"},"description":"Echoed or generated request trace ID"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Citation"},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"304":{"description":"Not Modified. ETag matched; no body returned."},"400":{"description":"Malformed id (too long)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown citation ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/jurisdictions/{code}":{"get":{"summary":"Jurisdiction detail with citations","operationId":"getJurisdiction","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"description":"Two-letter code (WA, HI), 'US' for federal, or a locality slug.","example":"WA"}],"responses":{"200":{"description":"Facts and full citations","headers":{"etag":{"schema":{"type":"string"},"description":"Catalog ETag for conditional GET"},"last-modified":{"schema":{"type":"string"},"description":"RFC 7231 date of last catalog update"},"vary":{"schema":{"type":"string"},"description":"Always 'Accept'"},"x-request-id":{"schema":{"type":"string"},"description":"Echoed or generated request trace ID"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/JurisdictionDetail"},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"304":{"description":"Not Modified. ETag matched; no body returned."},"400":{"description":"Malformed code (too long)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}},"components":{"schemas":{"ResponseMeta":{"type":"object","required":["apiVersion","schemaVersion","taxYear","catalogAsOf","source"],"properties":{"apiVersion":{"type":"string","example":"v1","description":"Path-level version. Bumps to v2 only on breaking URL/structure changes."},"schemaVersion":{"type":"string","example":"1.49.0","description":"Semver: MINOR bumps on new optional fields; MAJOR bumps on removals. Guard on this to detect field additions."},"taxYear":{"type":"integer","example":2025,"description":"Primary target tax year. Time-windowed facts (CPI-indexed exemptions) may include data from adjacent years; per-fact citations carry exact taxYear for precise vintage."},"catalogAsOf":{"type":"string","format":"date","example":"2026-07-04","description":"ISO date of the most recent catalog update. Use to determine data freshness."},"source":{"type":"string","example":"fed_salt catalog (primary .gov sources, verbatim-cited)"}}},"Citation":{"type":"object","description":"A verifiable pointer to a primary government source.","required":["id","jurisdiction","authority","authorityType","title","quote","url","sourceDomain","taxYear","asOf","confidence","href"],"properties":{"id":{"type":"string","example":"hi-cap-loss-carryforward-5yr","description":"Stable slug; dereference via /api/v1/citations/{id}."},"jurisdiction":{"type":"string","example":"HI"},"authority":{"type":"string","description":"The exact legal cite.","example":"HRS sec. 235-2.45(f)"},"authorityType":{"type":"string","enum":["constitution","statute","session-law","regulation","dor-guidance","form-instructions"],"description":"The tier of legal authority. constitution: state or federal constitution. statute: codified law (IRC, RCW, HRS). session-law: uncodified enacted law, typically a recent amendment. regulation: agency rule (Treasury Regulations, state DOR rules). dor-guidance: Department of Revenue administrative guidance (not binding statute). form-instructions: official published form instructions (IRS Publication, state return instructions)."},"title":{"type":"string"},"quote":{"type":"string","description":"Verbatim text from the source proving the fact."},"url":{"type":"string","format":"uri","description":"Deep link to the primary document (government domain)."},"sourceDomain":{"type":"string","example":"files.hawaii.gov"},"taxYear":{"oneOf":[{"type":"integer","example":2025},{"type":"array","items":{"type":"integer"},"minItems":2,"maxItems":2}]},"asOf":{"type":"string","format":"date","description":"When the source was read and verified."},"confidence":{"type":"string","enum":["high","medium","low"],"description":"Source certainty. high: verbatim statutory text confirmed against the live document. medium: agency guidance or form instructions, not codified statute. low: regulation pending update or figure derived from a secondary source pending re-verification."},"note":{"type":"string"},"href":{"type":"string","example":"/api/v1/citations/hi-cap-loss-carryforward-5yr","description":"Relative API path to this citation's canonical endpoint."}}},"Fact":{"type":"object","description":"One labeled, cited statement of tax law.","required":["factId","jurisdiction","category","label","display","value","valueType","citations","effectiveDate","terminalDate","nextReviewDate"],"properties":{"factId":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","description":"Stable immutable identifier. Never changes once encoded. Format: {jurisdiction-lowercase}-{category}[-{date-marker}]."},"jurisdiction":{"type":"string"},"category":{"type":"string","enum":["no-tax","rate","deduction","surcharge","carryforward","carryback","character","conformity","threshold","muni-instate","muni-outstate","treasury","agency-obligations","fhlb-ffcb","dividend-qualified","qoz-conformity","qsbs-conformity","migration-loss-conformity","estate-rate","estate-exemption","inheritance-rate","estate-none","community-property","marital-elective-cp","marital-udcprda","trust-nexus","filing-status-flat","filing-status-doubled","filing-status-identical","filing-status-partial","recapture-rate","charitable-agi-limit","charitable-carryforward","estate-exemption-sunset","section-291-rate","qsbs-exclusion-cap","qsbs-gross-asset-ceiling","qsbs-hold-years","corporate-rate","ptet-available","ptet-rate","ptet-credit-mechanism","depreciation","salt-deduction-cap","gift-annual-exclusion"],"description":"The type of tax fact. no-tax: jurisdiction imposes no tax of this type (value is null). rate: a marginal or flat tax rate (value is decimal fraction). deduction: a deductible amount (value is dollars). surcharge: an additional rate layered on top of the base rate. carryforward/carryback: capital loss carryforward years or carryback availability. character: long-term vs short-term capital gains treatment (exclusion-pct or none). conformity: whether/how the jurisdiction conforms to federal IRC treatment. threshold: a dollar threshold above which a rate or rule applies. muni-instate/muni-outstate: state treatment of municipal bond interest (1=exempt, 0=taxable). treasury: state treatment of US Treasury interest (all states exempt under 31 U.S.C. §3124). agency-obligations: state treatment of GSE bond interest not covered by direct federal exemption, primarily FNMA/Fannie Mae and FHLMC/Freddie Mac (FHLB and FFCB are federally exempt under their own enabling statutes; 1=state also exempts, 0=taxable). fhlb-ffcb: state treatment of Federal Home Loan Bank and Federal Farm Credit Banks bond interest; always 1=exempt under 12 U.S.C. §1433 (FHLB Act) and 12 U.S.C. §2023 (Farm Credit Act); contrasts with FNMA/FHLMC which have no such statutory bondholder exemption. dividend-qualified: state treatment of qualified dividends vs ordinary income (0=taxed at ordinary rates, 1=exempt, fractional=partial exclusion). qoz-conformity: state conformity to IRC §1400Z-2 QOZ gain deferral and exclusion (1=full, 2=in-state, 0=decoupled). qsbs-conformity: state conformity to IRC §1202 QSBS gain exclusion (1=conforms, 0=non-conforms, null=partial). migration-loss-conformity: state loss carryforward migration rules (1=full-conform, 2=recalculate, 0=disallowed). estate-rate: state estate tax top marginal rate (decimal fraction). estate-exemption: state estate tax exemption/exclusion threshold (dollars). inheritance-rate: state inheritance tax top rate for closest beneficiary class (decimal fraction). community-property: binary indicating community property state (1=yes, 0=no). marital-elective-cp: binary indicating state allows opt-in community property via trust (1=yes; covers AK/FL/KY/SD/TN). marital-udcprda: binary indicating state adopted the Uniform Disposition of Community Property Rights Act (1=yes). filing-status-flat: binary indicating state uses a flat income tax rate where filing status is irrelevant (1=yes). filing-status-doubled: binary indicating MFJ brackets are approximately 2x Single (marriage neutral; 1=yes). filing-status-identical: binary indicating same bracket schedule for all filing statuses (marriage penalty; 1=yes). filing-status-partial: binary indicating MFJ bracket thresholds are partially wider than single filer (neither fully doubled nor identical; some marriage penalty at higher income; 1=yes). depreciation: federal real-estate depreciation recovery period (years). recapture-rate: federal maximum rate on a recapture category, e.g. unrecaptured section 1250 gain (decimal fraction = 0.25). charitable-agi-limit: percent of AGI deductible for a class of charitable gift, e.g. appreciated LTCG property to a public charity (decimal fraction = 0.30). charitable-carryforward: years an unused charitable contribution deduction carries forward (5). estate-exemption-sunset: COUNTERFACTUAL pre-OBBBA TCJA-sunset estate exclusion (dollars; never enacted, for scenario modeling only). section-291-rate: corporate IRC §291(a)(1) ordinary add-back fraction on section 1250 gain (decimal fraction = 0.20). qsbs-exclusion-cap: IRC §1202 per-issuer dollar cap on excluded gain, date-windowed ($10M on/before 2025-07-04, $15M after, OBBBA). qsbs-gross-asset-ceiling: IRC §1202 issuer aggregate-gross-assets test, date-windowed ($50M -> $75M post-OBBBA). qsbs-hold-years: IRC §1202 holding period for full 100% exclusion (5 years). corporate-rate: top corporate income tax rate (federal IRC §11(b) = 0.21; per-state corporate rates). ptet-available: binary, state offers a pass-through entity tax (SALT-cap workaround) election (1=yes, 0=no). ptet-rate: the entity-level rate a state's PTET election taxes at (decimal fraction). ptet-credit-mechanism: code for how the owner recovers the entity-level PTET (0=credit, 1=deduction, 2=exclusion)."},"label":{"type":"string","example":"Capital-loss carryforward limit"},"display":{"type":"string","example":"5 years (15 for a qualified high-tech business)"},"value":{"type":["number","null"],"description":"Machine-readable form. Semantics depend on valueType: rate/surcharge: decimal fraction (0.07 = 7%); years: integer year count; dollars: whole USD; binary-exempt: 1=exempt 0=taxable; exclusion-pct: decimal fraction of income excluded; code: non-negative integer enum whose meaning is set by the category (e.g. qoz-conformity 0=decoupled/1=full/2=in-state); partial: always null; none: always null. Always prefer display for rendering to users.","example":0.07},"valueType":{"type":"string","enum":["rate","dollars","years","binary-exempt","exclusion-pct","code","partial","none"],"description":"Discriminant for the value field. rate: decimal fraction (0.07 = 7%). dollars: integer USD. years: integer year count. binary-exempt: 1=exempt/conforms, 0=taxable/non-conforms. exclusion-pct: decimal fraction of income excluded. code: non-negative integer enum code whose meaning is defined by the fact's category (e.g. qoz-conformity 0=decoupled/1=full/2=in-state, migration-loss-conformity 0=disallowed/1=full-conform/2=recalculate). partial: value is always null; state has a provision but with conditions or restrictions. none: value is always null; provision is qualitative only."},"derivation":{"type":"string","description":"Formula by which a computed value was derived from its cited inputs. Absent for directly-sourced values."},"citations":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/Citation"}},"effectiveDate":{"type":["string","null"],"pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"ISO YYYY-MM-DD: first date this version of the fact is effective. null means open start. Present when a value changed mid-year (e.g. legislation effective July 1) or replaced a prior version."},"terminalDate":{"type":["string","null"],"pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"ISO YYYY-MM-DD: last date this version of the fact applies. null means still current. Present for superseded values (mid-year law change) or CPI-indexed values that expire at year-end and need annual re-verification."},"nextReviewDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"ISO YYYY-MM-DD: re-verify this fact's source by this date. Always present. CPI-indexed facts are set to November before the next tax year; most facts are set ~12 months from last verification; stable facts (no-tax, community-property) are set ~24 months out."}}},"JurisdictionSummary":{"type":"object","required":["code","name","level","factCount","href"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"level":{"type":"string","enum":["federal","state","local","territory"]},"factCount":{"type":"integer"},"href":{"type":"string"}}},"JurisdictionDetail":{"type":"object","required":["code","name","level","facts"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"level":{"type":"string","enum":["federal","state","local","territory"]},"facts":{"type":"array","items":{"$ref":"#/components/schemas/Fact"}}}},"ErrorEnvelope":{"type":"object","required":["error","meta"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found","bad_request","internal_error"]},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true,"description":"Structured hint. Includes supported[] when error is not_found for an enum value."}}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}}