{"openapi":"3.1.0","info":{"title":"Castles.wiki API","version":"1.0.0","description":"Castles, forts and palaces of the world, sourced from Wikipedia.\n\nPublic, no API key required. Rate limited per IP."},"servers":[{"url":"http:\/\/castles.tello.app"}],"paths":{"\/api\/v1\/castles":{"get":{"operationId":"search_castles","summary":"Search castles by any attribute","parameters":[{"name":"search","in":"query","required":false,"description":"Match part of the castle's name.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Country name or slug, e.g. \"France\" or \"france\".","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Castle type, e.g. fortress, palace, hill castle (contains-match).","schema":{"type":"string"}},{"name":"architectural_style","in":"query","required":false,"description":"e.g. Gothic, Romanesque, Renaissance (contains-match).","schema":{"type":"string"}},{"name":"condition","in":"query","required":false,"description":"e.g. ruins, restored, intact (contains-match).","schema":{"type":"string"}},{"name":"heritage_designation","in":"query","required":false,"description":"e.g. UNESCO, scheduled monument (contains-match).","schema":{"type":"string"}},{"name":"materials","in":"query","required":false,"description":"Materials","schema":{"type":"string"}},{"name":"owner","in":"query","required":false,"description":"Owner","schema":{"type":"string"}},{"name":"open_to_public","in":"query","required":false,"description":"Open to public","schema":{"type":"string"}},{"name":"century_min","in":"query","required":false,"description":"Minimum Century built.","schema":{"type":"number"}},{"name":"century_max","in":"query","required":false,"description":"Maximum Century built.","schema":{"type":"number"}},{"name":"year_min","in":"query","required":false,"description":"Minimum Year built.","schema":{"type":"number"}},{"name":"year_max","in":"query","required":false,"description":"Maximum Year built.","schema":{"type":"number"}},{"name":"has_image","in":"query","required":false,"description":"Has photo","schema":{"type":"boolean"}},{"name":"has_coordinates","in":"query","required":false,"description":"Has coordinates","schema":{"type":"boolean"}},{"name":"has_year","in":"query","required":false,"description":"Has a known build year","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"Sort order.","schema":{"type":"string","enum":["name","year_built","century_built","type"]}},{"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 castles."}}}},"\/api\/v1\/castles\/{slug}":{"get":{"operationId":"get_castle","summary":"Get a single castle by slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"One castle."},"404":{"description":"Not found."}}}},"\/api\/v1\/countries":{"get":{"operationId":"list_countries","summary":"Countries that have castles, 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."}}}}}}