{"openapi":"3.0.3","info":{"title":"Arc & Ledger Tax Data API","version":"1.0.0","description":"Authority-cited U.S. tax data: annual federal tax parameters, IRC 7503-rolled filing deadlines, the IRC 6621 quarterly interest-rate table, and reference profiles for IRS notices and tax documents. Every value carries its authority citation, official URL, and tax-year vintage. General information, not tax or legal advice for any taxpayer. Free tier: no key, 30 requests/minute per IP. Docs: https://www.arcandledger.com/developers/","contact":{"name":"Arc & Ledger Accounting","url":"https://www.arcandledger.com/developers/"}},"servers":[{"url":"https://api.arcandledger.com"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"parameters":{"year":{"name":"year","in":"query","required":false,"schema":{"type":"integer","example":2026},"description":"Tax-year vintage; defaults to the latest complete vintage."}},"schemas":{"Envelope":{"type":"object","required":["data","meta","disclaimer"],"properties":{"data":{"type":"object"},"meta":{"type":"object","required":["serverVersion"],"properties":{"serverVersion":{"type":"string"},"taxYear":{"type":"integer"}}},"disclaimer":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","status","message"],"properties":{"code":{"type":"string"},"status":{"type":"integer"},"message":{"type":"string"}}}}},"Authority":{"type":"object","required":["cite","url","kind"],"properties":{"cite":{"type":"string","example":"Rev. Proc. 2025-32"},"url":{"type":"string","format":"uri"},"kind":{"type":"string","enum":["statute","regulation","rev_proc","rev_rul","notice","announcement","public_law","form_instructions","agency_page"]}}},"TaxParam":{"type":"object","required":["id","taxYear","value","unit","authority","effectiveFrom","effectiveTo","status"],"properties":{"id":{"type":"string","example":"standard_deduction.single"},"taxYear":{"type":"integer"},"value":{"type":"number"},"unit":{"type":"string","enum":["usd","rate","usd_per_mile","usd_per_sqft","years","count"]},"authority":{"$ref":"#/components/schemas/Authority"},"effectiveFrom":{"type":"string","format":"date"},"effectiveTo":{"type":"string","format":"date","nullable":true},"status":{"type":"string","enum":["enacted"]},"notes":{"type":"string"}}}}},"paths":{"/v1/tax-parameters":{"get":{"summary":"All tax parameters for a vintage","parameters":[{"$ref":"#/components/parameters/year"}],"responses":{"200":{"description":"Parameters with citations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Invalid year","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown vintage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tax-parameters/{id}":{"get":{"summary":"One parameter by id (all effective windows)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"mileage.business"},{"$ref":"#/components/parameters/year"}],"responses":{"200":{"description":"Matching records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Unknown parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/deadlines":{"get":{"summary":"Federal filing deadlines, IRC 7503-rolled","parameters":[{"$ref":"#/components/parameters/year"}],"responses":{"200":{"description":"Statutory vs observed dates per form family","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Invalid year","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/deadlines/estimated-payments":{"get":{"summary":"Quarterly estimated-payment due dates","parameters":[{"$ref":"#/components/parameters/year"}],"responses":{"200":{"description":"Four rolled due dates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/v1/interest-rates":{"get":{"summary":"IRC 6621 quarterly interest rates (2020-Q1 to present)","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-Q[1-4]$"},"example":"2024-Q1"},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-Q[1-4]$"},"example":"2026-Q3"}],"responses":{"200":{"description":"Five rate categories per quarter with authority","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Invalid quarter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/notices":{"get":{"summary":"IRS notice profiles (index)","responses":{"200":{"description":"Notice codes with titles and urgency","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/v1/notices/{code}":{"get":{"summary":"One IRS notice profile","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"example":"CP2000"}],"responses":{"200":{"description":"Full profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Unknown code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tax-documents":{"get":{"summary":"Tax-document profiles (index)","responses":{"200":{"description":"Document ids with titles and categories","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/v1/tax-documents/{id}":{"get":{"summary":"One tax-document profile","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"1099K"}],"responses":{"200":{"description":"Full profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Unknown document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/vintages":{"get":{"summary":"Available vintages and coverage","responses":{"200":{"description":"Vintage registry and interest-rate verification date","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/v1/openapi.json":{"get":{"summary":"This specification","responses":{"200":{"description":"OpenAPI 3.0 document"}}}}}}