{"openapi":"3.1.0","info":{"title":"Open Scholarships API","description":"A free, openly-licensed (**CC BY 4.0**) directory of scholarships and student financial aid in the United States.\n\nFacts are gathered from **primary, official sources** (state agencies, public universities, foundations) and every record carries the source it was verified against. Only human-verified records are served.\n\n- No key, no signup — CORS-open, returns JSON.\n- Full dataset: `GET /scholarships.json`\n- Filtered queries: `GET /api/scholarships` (state · level · field · basis · type · sponsor_type · availability · deadline · amount · free-text `q`)\n- Source & data: [github.com/Grudged/open-scholarships](https://github.com/Grudged/open-scholarships)","termsOfService":"https://scholarships.grudged.io/","contact":{"name":"Grudged LLC","url":"https://grudged.io/"},"license":{"name":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"version":"0.1.0"},"servers":[{"url":"https://scholarships.grudged.io","description":"Production"}],"paths":{"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/meta.json":{"get":{"summary":"Meta","operationId":"meta_meta_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/meta":{"get":{"summary":"Meta","operationId":"meta_meta_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/scholarships.json":{"get":{"summary":"Bundle","operationId":"bundle_scholarships_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/scholarships":{"get":{"summary":"List Scholarships","operationId":"list_scholarships_api_scholarships_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"education_level value, e.g. high-school-senior","title":"Level"},"description":"education_level value, e.g. high-school-senior"},{"name":"field","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"field of study; records open to any field always match","title":"Field"},"description":"field of study; records open to any field always match"},{"name":"basis","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basis"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"sponsor_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor Type"}},{"name":"availability","in":"query","required":false,"schema":{"anyOf":[{"enum":["open","upcoming","closed","rolling","unknown"],"type":"string"},{"type":"null"}],"description":"filter by computed cycle status: open | upcoming | closed | rolling | unknown","title":"Availability"},"description":"filter by computed cycle status: open | upcoming | closed | rolling | unknown"},{"name":"deadline_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO date; undated (rolling) records always match","title":"Deadline After"},"description":"ISO date; undated (rolling) records always match"},{"name":"amount_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount Min"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"free-text over name/summary/sponsor","title":"Q"},"description":"free-text over name/summary/sponsor"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/scholarships":{"get":{"summary":"List Scholarships","operationId":"list_scholarships_scholarships_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"education_level value, e.g. high-school-senior","title":"Level"},"description":"education_level value, e.g. high-school-senior"},{"name":"field","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"field of study; records open to any field always match","title":"Field"},"description":"field of study; records open to any field always match"},{"name":"basis","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basis"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"sponsor_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor Type"}},{"name":"availability","in":"query","required":false,"schema":{"anyOf":[{"enum":["open","upcoming","closed","rolling","unknown"],"type":"string"},{"type":"null"}],"description":"filter by computed cycle status: open | upcoming | closed | rolling | unknown","title":"Availability"},"description":"filter by computed cycle status: open | upcoming | closed | rolling | unknown"},{"name":"deadline_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO date; undated (rolling) records always match","title":"Deadline After"},"description":"ISO date; undated (rolling) records always match"},{"name":"amount_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount Min"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"free-text over name/summary/sponsor","title":"Q"},"description":"free-text over name/summary/sponsor"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/scholarships/{scholarship_id}":{"get":{"summary":"Get Scholarship","operationId":"get_scholarship_api_scholarships__scholarship_id__get","parameters":[{"name":"scholarship_id","in":"path","required":true,"schema":{"type":"string","title":"Scholarship Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/scholarships/{scholarship_id}":{"get":{"summary":"Get Scholarship","operationId":"get_scholarship_scholarships__scholarship_id__get","parameters":[{"name":"scholarship_id","in":"path","required":true,"schema":{"type":"string","title":"Scholarship Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Docs Page","operationId":"docs_page__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}