{"openapi":"3.1.1","info":{"title":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: Returns and other forms filed, gross tax collections and refunds issued, from the Internal Revenue Service Data Book state tables, for the nation, each state, DC and Puerto Rico and each fiscal year (October to September) from 2019 to 2025: returns by form type (individual, employment, C corporation, S corporation, partnership), collections by type of tax (individual income and employment, withheld, business income, estate, gift, excise) and the number and amount of refunds. Dollar amounts are in dollars; IRS prints them in thousands. The national record also holds what IRS counts in the nation but assigns to no state.\n\nProbative is a marketing firm, not a law firm; not legal advice. Every JSON response starts with a \"meta\" object holding the credit line, citation, DOI and license (CC BY 4.0).","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"Probative Growth","url":"https://probativegrowth.com/contact/","email":"hello@probativegrowth.com"}},"servers":[{"url":"https://probativegrowth.com"}],"externalDocs":{"description":"How to use the API and the MCP server","url":"https://probativegrowth.com/resources/rules-api/"},"paths":{"/data/v1/irs-databook/index.json":{"get":{"summary":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: index","description":"irs-databook: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["irs-databook"]}},"/data/v1/irs-databook/changes.json":{"get":{"summary":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: confirmed changes","description":"irs-databook: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["irs-databook"]}},"/data/v1/irs-databook/jurisdictions/{key}.json":{"get":{"summary":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: one jurisdiction","description":"irs-databook: the records for one jurisdiction","parameters":[{"name":"key","in":"path","required":true,"description":"The jurisdiction key, uppercase","schema":{"type":"string"},"example":"AK"}],"responses":{"200":{"description":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["irs-databook"]}},"/data/v1/irs-databook/irs-databook.csv":{"get":{"summary":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025 as CSV","description":"irs-databook: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025 as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["irs-databook"]}},"/data/v1/irs-databook/irs-databook.json":{"get":{"summary":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: every record","description":"irs-databook: every record in one file","parameters":[],"responses":{"200":{"description":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["irs-databook"]}},"/data/v1/irs-databook/search.json":{"get":{"summary":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: keyword index","description":"irs-databook: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"IRS Data Book by state: returns filed, gross tax collections and refunds, fiscal years 2019 to 2025: keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["irs-databook"]}},"/data/v1/irs-databook/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"irs-databook: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["irs-databook"]}}},"components":{"schemas":{"Meta":{"type":"object","description":"Credit line, citation, DOI, version, license and disclaimer. Present in every response.","required":["dataset","version","license","attribution","disclaimer","url"],"properties":{"dataset":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"doi":{"type":["string","null"]},"doiUrl":{"type":["string","null"]},"conceptDoi":{"type":["string","null"]},"license":{"type":"string","const":"CC BY 4.0"},"licenseUrl":{"type":"string"},"attribution":{"type":"string"},"citation":{"type":"string"},"disclaimer":{"type":"string"},"notice":{"type":"string"},"lastChecked":{"type":"string"},"url":{"type":"string"},"humanUrl":{"type":"string"},"statusCodes":{"type":"object"}}},"Envelope":{"type":"object","required":["meta"],"properties":{"meta":{"$ref":"#/components/schemas/Meta"}},"additionalProperties":true}}}}