{"openapi":"3.0.0","info":{"title":"1703 Census API","description":"API for accessing the 1703 Icelandic census data, including detailed statistics about population, farms, and livestock.","version":"1.0.0","contact":{"name":"Islandsvefir","url":"https://github.com/Asdisarson/1703"},"license":{"name":"MIT","url":"https://github.com/Asdisarson/1703/blob/main/LICENSE"}},"servers":[{"url":"http://localhost:3000/api/v1","description":"Development server"}],"tags":[{"name":"Population","description":"Population statistics endpoints"},{"name":"Farms","description":"Farm statistics and information endpoints"},{"name":"Livestock","description":"Livestock statistics endpoints"},{"name":"Statistics","description":"General demographic and household statistics"}],"paths":{"/population/total":{"get":{"tags":["Population"],"summary":"Get total population count","description":"Returns the total population count from the 1703 census","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number","example":50000}}}}}}}}},"/population/by-district":{"get":{"tags":["Population"],"summary":"Get population by district","description":"Returns population statistics broken down by district","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"districts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"Árnessýsla"},"population":{"type":"number","example":1000}}}}}}}}}}}},"/farms/occupancy":{"get":{"tags":["Farms"],"summary":"Get farm occupancy statistics","description":"Returns statistics about farm occupancy rates","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"occupied":{"type":"number","example":800},"vacant":{"type":"number","example":200},"total":{"type":"number","example":1000}}}}}}}}},"/farms/{byliNr}":{"get":{"tags":["Farms"],"summary":"Get farm details","description":"Returns detailed information about a specific farm","parameters":[{"name":"byliNr","in":"path","required":true,"description":"Farm identifier number","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"byliNr":{"type":"integer","example":1},"name":{"type":"string","example":"Stóri-Núpur"},"district":{"type":"string","example":"Árnessýsla"},"value":{"type":"number","example":60},"occupants":{"type":"integer","example":12}}}}}},"404":{"description":"Farm not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"error"},"message":{"type":"string","example":"Farm not found"}}}}}}}}},"/livestock/cattle":{"get":{"tags":["Livestock"],"summary":"Get cattle statistics","description":"Returns statistics about cattle ownership and distribution","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number","example":5000},"byDistrict":{"type":"array","items":{"type":"object","properties":{"district":{"type":"string","example":"Árnessýsla"},"count":{"type":"number","example":500}}}}}}}}}}}},"/statistics/demographics/age-gender":{"get":{"tags":["Statistics"],"summary":"Get age and gender statistics","description":"Returns population statistics broken down by age groups and gender","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ageGroups":{"type":"array","items":{"type":"object","properties":{"range":{"type":"string","example":"0-10"},"male":{"type":"number","example":2500},"female":{"type":"number","example":2300}}}}}}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"status":{"type":"string","example":"error"},"message":{"type":"string"}}}}}}