{"openapi":"3.1.0","info":{"title":"Waterfalls API","version":"1.0.0","description":"Explore thousands of waterfalls worldwide \u2014 by height, type, and country. Sourced and kept in sync from Wikipedia.\n\nPublic, no API key required. Rate limited per IP."},"servers":[{"url":"http:\/\/waterfalls.tello.app"}],"paths":{"\/api\/v1\/locations":{"get":{"operationId":"search_locations","summary":"Search locations by any attribute","parameters":[{"name":"search","in":"query","required":false,"description":"Match part of the waterfall's name.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Country name or slug, e.g. \"Norway\" or \"norway\".","schema":{"type":"string"}},{"name":"height_m_min","in":"query","required":false,"description":"Minimum Height (m).","schema":{"type":"number"}},{"name":"height_m_max","in":"query","required":false,"description":"Maximum Height (m).","schema":{"type":"number"}},{"name":"type","in":"query","required":false,"description":"Type","schema":{"type":"string","enum":["Plunge","Cascade","Tiered","Block","Horsetail","Fan","Cataract","Chute","Punchbowl","Segmented"]}},{"name":"num_drops_min","in":"query","required":false,"description":"Minimum Number of drops.","schema":{"type":"number"}},{"name":"num_drops_max","in":"query","required":false,"description":"Maximum Number of drops.","schema":{"type":"number"}},{"name":"watercourse","in":"query","required":false,"description":"River \/ watercourse","schema":{"type":"string"}},{"name":"has_image","in":"query","required":false,"description":"Only entries with a photo.","schema":{"type":"boolean"}},{"name":"has_coordinates","in":"query","required":false,"description":"Only entries with a location on the map.","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"Sort order.","schema":{"type":"string","enum":["height_desc","name","newest"]}},{"name":"limit","in":"query","required":false,"description":"Max results (default 36, max 100).","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Pagination offset.","schema":{"type":"integer"}}],"responses":{"200":{"description":"A page of locations."}}}},"\/api\/v1\/locations\/{slug}":{"get":{"operationId":"get_location","summary":"Get a single location by slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"One location."},"404":{"description":"Not found."}}}},"\/api\/v1\/countries":{"get":{"operationId":"list_countries","summary":"Countries that have locations, with counts","responses":{"200":{"description":"Country list."}}}},"\/api\/v1\/schema":{"get":{"operationId":"describe_filters","summary":"Machine-readable list of every queryable attribute","responses":{"200":{"description":"The agent schema."}}}}}}