{"openapi":"3.1.0","info":{"title":"FuelTax IFTA Rates API","version":"0.1.0","description":"IFTA quarterly tax rate matrix (iftach.org), human-reviewed import each quarter. Reference data. Verify against the official IFTA matrix before filing. Paid endpoints use the x402 payment protocol (base, USDC): expect HTTP 402 with PAYMENT-REQUIRED, retry with PAYMENT-SIGNATURE."},"servers":[{"url":"https://api.freestylevault.com"}],"paths":{"/v1/quarters":{"get":{"summary":"Published quarters catalog (free)","operationId":"listQuarters","responses":{"200":{"description":"Quarters, newest first.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","example":"2026-Q2"},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"},"filing_deadline":{"type":"string","format":"date"},"fuel_types":{"type":"array","items":{"type":"string"}},"jurisdiction_count":{"type":"integer"},"has_mid_quarter_revision":{"type":"boolean"}}}},"meta":{"type":"object","description":"Attribution, disclaimer, generated_at, and endpoint-specific extras.","properties":{"source":{"type":"string"},"disclaimer":{"type":"string"},"generated_at":{"type":"string","format":"date-time"}},"additionalProperties":true}}}}}}}}},"/v1/quarters/{quarter}":{"get":{"summary":"One quarter's catalog entry (free)","operationId":"getQuarter","parameters":[{"name":"quarter","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{4}-Q[1-4]$","example":"2026-Q2"},"description":"Quarter label, YYYY-Qn."}],"responses":{"200":{"description":"Catalog entry."},"404":{"description":"Quarter not published."}}}},"/v1/jurisdictions":{"get":{"summary":"IFTA jurisdiction registry (free)","operationId":"listJurisdictions","responses":{"200":{"description":"All jurisdictions.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","example":"WA"},"name":{"type":"string"},"country":{"type":"string","enum":["US","CA"]},"ifta_member":{"type":"boolean"},"has_surcharge":{"type":"boolean"},"weight_distance_program":{"type":["string","null"],"example":"OR_WM"}}}},"meta":{"type":"object","description":"Attribution, disclaimer, generated_at, and endpoint-specific extras.","properties":{"source":{"type":"string"},"disclaimer":{"type":"string"},"generated_at":{"type":"string","format":"date-time"}},"additionalProperties":true}}}}}}}}},"/v1/rates":{"get":{"summary":"Committed IFTA rates for a quarter","operationId":"listRates","parameters":[{"name":"quarter","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-Q[1-4]$"},"description":"Defaults to the latest published quarter."},{"name":"fuel_type","in":"query","required":false,"schema":{"type":"string","example":"diesel"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2,"example":"WA"}}],"responses":{"200":{"description":"Jurisdiction × fuel-type entries with effective periods clipped to the quarter.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"jurisdiction":{"type":"string","example":"WA"},"name":{"type":"string"},"country":{"type":"string"},"fuel_type":{"type":"string"},"periods":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"},"rate":{"type":"string","example":"0.584000","description":"6-decimal string, USD per gallon."},"surcharge_rate":{"type":["string","null"],"example":"0.110000"},"credit_eligible":{"type":"boolean"}}}}}}},"meta":{"type":"object","description":"Attribution, disclaimer, generated_at, and endpoint-specific extras.","properties":{"source":{"type":"string"},"disclaimer":{"type":"string"},"generated_at":{"type":"string","format":"date-time"}},"additionalProperties":true}}}}}},"402":{"description":"Payment required (x402). Body carries `accepts` payment requirements."},"404":{"description":"Quarter not published."},"422":{"description":"Malformed parameter."}},"x-x402":{"price":"$0.005","asset":"USDC","network":"base","caip2":"eip155:8453","payTo":"0x421d31725e1e7990662600a780ebbb6c92f1cb09"}}},"/v1/quarters/{quarter}/changes":{"get":{"summary":"Quarter-over-quarter rate changes","operationId":"getQuarterChanges","parameters":[{"name":"quarter","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{4}-Q[1-4]$","example":"2026-Q2"},"description":"Quarter label, YYYY-Qn."}],"responses":{"200":{"description":"type=diff with changes (old/new/6-decimal delta), added, removed, unchanged_count; or type=no_baseline for the first published quarter."},"402":{"description":"Payment required (x402)."},"404":{"description":"Quarter not published."}},"x-x402":{"price":"$0.01","asset":"USDC","network":"base","caip2":"eip155:8453","payTo":"0x421d31725e1e7990662600a780ebbb6c92f1cb09"}}},"/v1/quarters/{quarter}/footnotes":{"get":{"summary":"Official matrix footnotes for a quarter","operationId":"getQuarterFootnotes","parameters":[{"name":"quarter","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{4}-Q[1-4]$","example":"2026-Q2"},"description":"Quarter label, YYYY-Qn."}],"responses":{"200":{"description":"Footnote entries {id, jurisdiction, text}. `jurisdiction` is the full uppercase name verbatim from the matrix."},"402":{"description":"Payment required (x402)."},"404":{"description":"Quarter not published, or metadata not captured for it."}},"x-x402":{"price":"$0.002","asset":"USDC","network":"base","caip2":"eip155:8453","payTo":"0x421d31725e1e7990662600a780ebbb6c92f1cb09"}}},"/v1/quarters/{quarter}/exchange-rate":{"get":{"summary":"Published USD/CAD exchange rate for a quarter","operationId":"getQuarterExchangeRate","parameters":[{"name":"quarter","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{4}-Q[1-4]$","example":"2026-Q2"},"description":"Quarter label, YYYY-Qn."}],"responses":{"200":{"description":"{usd_to_cad, cad_to_usd} as published in the matrix."},"402":{"description":"Payment required (x402)."},"404":{"description":"Quarter not published, or no exchange rate in that matrix."}},"x-x402":{"price":"$0.002","asset":"USDC","network":"base","caip2":"eip155:8453","payTo":"0x421d31725e1e7990662600a780ebbb6c92f1cb09"}}}}}