{"openapi":"3.1.0","info":{"title":"Choicely Kids API","version":"0.1.0","description":"Children's activities, classes and camps in Fremont, CA. Read-only. Personal, non-commercial use; bulk collection prohibited (https://kids.choicely.ai/terms)."},"servers":[{"url":"https://kids.choicely.ai"}],"paths":{"/api/v1/places":{"get":{"operationId":"searchPlaces","summary":"Find activity providers near a place","parameters":[{"name":"near","in":"query","schema":{"type":"string"},"description":"Fremont neighbourhood (e.g. Irvington, Mission San Jose, Ardenwood) or ZIP code"},{"name":"latitude","in":"query","schema":{"type":"number"}},{"name":"longitude","in":"query","schema":{"type":"number"}},{"name":"activity_type","in":"query","schema":{"type":"string","enum":["general","academic","sports","dance","music","stem","art","martial_arts","performing_arts"]}},{"name":"keyword","in":"query","schema":{"type":"string","minLength":3}},{"name":"child_age","in":"query","schema":{"type":"integer","minimum":0,"maximum":18}},{"name":"radius_miles","in":"query","schema":{"type":"number","minimum":0.5,"maximum":10,"default":5}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":3,"default":1}}],"responses":{"200":{"description":"Results (max 10 per page)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters"},"429":{"description":"Rate limited"}}}},"/api/v1/classes":{"get":{"operationId":"searchClasses","summary":"Find dated class sessions","parameters":[{"name":"near","in":"query","schema":{"type":"string"},"description":"Fremont neighbourhood (e.g. Irvington, Mission San Jose, Ardenwood) or ZIP code"},{"name":"latitude","in":"query","schema":{"type":"number"}},{"name":"longitude","in":"query","schema":{"type":"number"}},{"name":"activity_type","in":"query","schema":{"type":"string","enum":["general","academic","sports","dance","music","stem","art","martial_arts","performing_arts"]}},{"name":"keyword","in":"query","schema":{"type":"string","minLength":3}},{"name":"child_age","in":"query","schema":{"type":"integer","minimum":0,"maximum":18}},{"name":"radius_miles","in":"query","schema":{"type":"number","minimum":0.5,"maximum":10,"default":5}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":3,"default":1}},{"name":"days","in":"query","schema":{"type":"string"},"description":"comma-separated mon,tue,...,sun"},{"name":"time_of_day","in":"query","schema":{"type":"string","enum":["morning","afternoon","evening"]}},{"name":"starting_after","in":"query","schema":{"type":"string","format":"date"}},{"name":"starting_before","in":"query","schema":{"type":"string","format":"date"}},{"name":"max_price_dollars","in":"query","schema":{"type":"number"}},{"name":"only_with_openings","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Results (max 10 per page)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters"},"429":{"description":"Rate limited"}}}},"/api/v1/places/{place_id}":{"get":{"operationId":"placeDetails","summary":"One place and its upcoming classes","parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Results (max 10 per page)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters"},"429":{"description":"Rate limited"}}}}}}