{"openapi":"3.1.0","info":{"title":"Govt Scheme Eligibility Navigator API","version":"1.0.0","summary":"Free, public API to match a citizen profile against curated Indian central + state government schemes.","description":"Filter-based eligibility matcher. No live MyScheme calls, no AI. Dataset snapshot: 2026-06-01. Source: https://www.myscheme.gov.in.","contact":{"name":"Krake Labs India","url":"https://krakelabsindia.com"},"license":{"name":"Best-effort free service","url":"https://schemes.krakelabsindia.com/developers"}},"servers":[{"url":"https://schemes.krakelabsindia.com","description":"Production"}],"paths":{"/api/match":{"post":{"summary":"Match citizen profile against schemes","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"},"example":{"age":32,"state":"MH","gender":"female","annualIncome":250000,"isFarmer":false,"isStudent":false,"isBPL":false,"hasBankAccount":true,"occupation":"working","category":"GEN","areaType":"urban"}}}},"responses":{"200":{"description":"List of matched schemes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchResponse"}}}}}},"get":{"summary":"Match via query string (curl-friendly)","parameters":[{"name":"age","in":"query","schema":{"type":"integer"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"gender","in":"query","schema":{"type":"string"}},{"name":"annualIncome","in":"query","schema":{"type":"integer"}},{"name":"isFarmer","in":"query","schema":{"type":"boolean"}},{"name":"isStudent","in":"query","schema":{"type":"boolean"}},{"name":"isBPL","in":"query","schema":{"type":"boolean"}},{"name":"hasBankAccount","in":"query","schema":{"type":"boolean"}},{"name":"occupation","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"areaType","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"List of matched schemes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchResponse"}}}}}}},"/api/schemes":{"get":{"summary":"List all schemes (paginated, filterable)","parameters":[{"name":"sector","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Paginated scheme list","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/meta":{"get":{"summary":"Dataset metadata (counts, snapshot date)","responses":{"200":{"description":"Metadata","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Profile":{"type":"object","properties":{"age":{"type":"integer","minimum":0,"maximum":120},"state":{"type":"string","description":"2-letter state/UT code (e.g. MH, KA, DL)."},"gender":{"type":"string","enum":["male","female","other"]},"annualIncome":{"type":"integer","minimum":0},"isFarmer":{"type":"boolean"},"isStudent":{"type":"boolean"},"isBPL":{"type":"boolean"},"hasBankAccount":{"type":"boolean"},"occupation":{"type":"string","enum":["farmer","student","working","self-employed","retired","unemployed","any"]},"category":{"type":"string","enum":["GEN","OBC","SC","ST","MINORITY","ANY"]},"areaType":{"type":"string","enum":["urban","rural","any"]}},"required":["age","state"]},"MatchResponse":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/Profile"},"count":{"type":"integer"},"schemes":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"object"},"score":{"type":"number"},"reasons":{"type":"array","items":{"type":"string"}},"stateMatch":{"type":"boolean"}}}}}}}}}