{"info":{"contact":{"url":"https://whosbirthdayisit.today"},"description":"Public JSON API for famous birthdays ranked by Wikipedia popularity. Use /api/today for today's list, or /api/birthdays for any calendar day.","title":"whosbirthdayisit.today Birthdays API","version":"1.0.0"},"openapi":"3.0.3","paths":{"/api/birthdays":{"get":{"operationId":"getBirthdays","parameters":[{"in":"query","name":"month","schema":{"maximum":12,"minimum":1,"type":"integer"}},{"in":"query","name":"day","schema":{"maximum":31,"minimum":1,"type":"integer"}},{"in":"query","name":"category","schema":{"default":"all","enum":["actor","all","athlete","musician","other","politician","scientist"],"type":"string"}},{"in":"query","name":"gender","schema":{"default":"all","enum":["all","female","male"],"type":"string"}},{"in":"query","name":"alive","schema":{"default":"all","enum":["alive","all","deceased"],"type":"string"}},{"in":"query","name":"limit","schema":{"default":100,"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Ranked birthday payload with meta + people"}},"summary":"Famous birthdays for a calendar day"}},"/api/today":{"get":{"operationId":"getTodaysBirthdays","parameters":[{"in":"query","name":"category","schema":{"default":"all","enum":["actor","all","athlete","musician","other","politician","scientist"],"type":"string"}},{"in":"query","name":"gender","schema":{"default":"all","enum":["all","female","male"],"type":"string"}},{"in":"query","name":"alive","schema":{"default":"all","enum":["alive","all","deceased"],"type":"string"}},{"in":"query","name":"limit","schema":{"default":50,"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Ranked birthday payload with meta + people"}},"summary":"Famous birthdays today"}}},"servers":[{"url":"https://whosbirthdayisit.today"}]}