{"openapi":"3.1.0","info":{"title":"ThynkTax Public Tax Law API","version":"1.0","description":"Free, public REST API for Indian tax law - IT Act 2025 sections, GST/HSN rates, DTAA treaties, landmark case law, CBDT circulars, validation rules.","contact":{"name":"ThynkTax","email":"api@thynktax.com","url":"https://localhost:3020/api-docs"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://localhost:3020/api","description":"Production"}],"paths":{"/ask":{"post":{"summary":"Natural-language question against the tax law corpus","description":"POST a question; receive a structured answer with up to 3 cited sources.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"type":"string","maxLength":500}}}}}},"responses":{"200":{"description":"Synthetic answer with citations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}}}}},"/tax-law/sections":{"get":{"summary":"List statutory sections for a domain","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","enum":["ITR","GST","TDS","ROC","ESI_PF"]}}],"responses":{"200":{"description":"Array of TaxLaw records"}}}},"/tax-law/sections/by-2025-ref/{ref}":{"get":{"summary":"Look up IT Act 1961 sections by their IT Act 2025 section number","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Array of TaxLaw records"}}}},"/tax-law/case-laws":{"get":{"summary":"List landmark case laws","parameters":[{"name":"domain","in":"query","schema":{"type":"string"}},{"name":"jurisdiction","in":"query","schema":{"type":"string","enum":["SUPREME_COURT","HIGH_COURT","ITAT","AAR","AAAR"]}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":200}}],"responses":{"200":{"description":"Array of CASE_LAW records"}}}},"/tax-law/circulars":{"get":{"summary":"List CBDT/CBIC/MCA/EPFO circulars and notifications","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"}},{"name":"jurisdiction","in":"query","schema":{"type":"string","enum":["CBDT","CBIC","MCA","EPFO"]}}],"responses":{"200":{"description":"Array of CIRCULAR / NOTIFICATION records"}}}},"/tax-law/by-tag/{tag}":{"get":{"summary":"Fetch by tag (e.g. validation-check, form-rename, case-law-landmark)","parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Array of TaxLaw records carrying the tag"}}}},"/tax-law/{reference}":{"get":{"summary":"Look up a single tax law by reference string","parameters":[{"name":"reference","in":"path","required":true,"schema":{"type":"string"},"example":"Section 80C"}],"responses":{"200":{"description":"Single TaxLaw record"},"404":{"description":"Not found"}}}},"/tax-law/stats":{"get":{"summary":"Live counters - sections, case laws, circulars, validation checks, etc.","responses":{"200":{"description":"Aggregate counts"}}}},"/tax-rules/dtaa":{"get":{"summary":"List all DTAA treaties India has signed","responses":{"200":{"description":"Array of treaty rate records"}}}},"/tax-rules/dtaa/{iso}":{"get":{"summary":"DTAA treaty rates by ISO country code","parameters":[{"name":"iso","in":"path","required":true,"schema":{"type":"string"},"example":"US"}],"responses":{"200":{"description":"Treaty record"}}}},"/tax-rules/hsn/{code}":{"get":{"summary":"HSN code lookup - description, GST rate, cess","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"HSN record"}}}},"/tax-rules/it-slabs/{fy}/{regime}":{"get":{"summary":"Income tax slabs by FY and regime","parameters":[{"name":"fy","in":"path","required":true,"schema":{"type":"string"},"example":"2026-27"},{"name":"regime","in":"path","required":true,"schema":{"type":"string","enum":["old","new"]}}],"responses":{"200":{"description":"Array of slab records"}}}}},"components":{"schemas":{"Answer":{"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string","description":"Markdown-formatted synthetic answer"},"citations":{"type":"array","items":{"$ref":"#/components/schemas/Citation"}},"followUps":{"type":"array","items":{"type":"string"}}}},"Citation":{"type":"object","properties":{"title":{"type":"string"},"reference":{"type":"string"},"summary":{"type":"string"},"url":{"type":"string","format":"uri"},"category":{"type":"string"},"jurisdiction":{"type":"string"}}}}}}