{"openapi":"3.1.0","info":{"title":"Chicken Coop API","version":"1.0.0","description":"Backyard-chicken housing maths as an API, computed locally and deterministically — the coop, run and fixture numbers a flock keeper builds to. The space endpoint sizes the housing from the flock and the breed: about 4 ft² of coop floor per standard hen (2 for bantams, 5 for heavy breeds) plus roughly 10 ft² of run each, so ten standard hens want a 40 ft² coop and a 100 ft² run — and given a coop width it returns the length, or zero run for birds that free-range and only roost inside. The fixtures endpoint covers the inside: one nest box per three to four hens (they share and queue, so ten hens need three), 8–12 inches of roost bar per bird (ten birds ≈ 8.3 feet), about 4 inches of linear feeder space each, and a waterer per eight or so birds. Crowding is the root of pecking, disease and mess, so every figure rounds up and more space is always better; roosts should sit higher than the nest boxes so the birds don’t sleep — and soil — in them. Everything is computed locally and deterministically, so it is instant and private. Ideal for homesteading, backyard-poultry, farm and smallholding app developers, coop-planner and flock-management tools, and self-sufficiency software. Pure local computation — no key, no third-party service, instant. US units, rules of thumb. Live, nothing stored. 2 compute endpoints. For feed quantities use a different API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/chickencoop-api","description":"oanor gateway"}],"tags":[{"name":"Coop"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/fixtures":{"get":{"operationId":"get_v1_fixtures","tags":["Coop"],"summary":"Nest boxes, roost, feeders","description":"","parameters":[{"name":"birds","in":"query","required":true,"description":"Number of birds","schema":{"type":"string"},"example":"10"},{"name":"hens_per_box","in":"query","required":false,"description":"Hens per nest box (default 4)","schema":{"type":"string"},"example":"4"},{"name":"roost_in_per_bird","in":"query","required":false,"description":"Roost inches per bird (default 10)","schema":{"type":"string"},"example":"10"},{"name":"feeder_in_per_bird","in":"query","required":false,"description":"Feeder inches per bird (default 4)","schema":{"type":"string"},"example":"4"},{"name":"birds_per_waterer","in":"query","required":false,"description":"Birds per waterer (default 8)","schema":{"type":"string"},"example":"8"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"One nest box per 3–4 hens (they share and queue), 8–12\" of roost bar per bird, ~4\" of linear feeder space each, and a waterer per ~8 birds. Roosts should sit higher than the nest boxes so birds don't sleep — and poop — in the nests.","inputs":{"birds":10,"hens_per_box":4,"birds_per_waterer":8,"roost_in_per_bird":10,"feeder_in_per_bird":4},"waterers":2,"nest_boxes":3,"roost_length_ft":8.33,"roost_length_in":100,"feeder_length_ft":3.33,"feeder_length_in":40},"meta":{"timestamp":"2026-06-06T07:13:59.821Z","request_id":"c4ad1ec4-b230-4507-8a4a-052ead5051d3"},"status":"ok","message":"Coop fixtures","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/space":{"get":{"operationId":"get_v1_space","tags":["Coop"],"summary":"Coop & run sizing","description":"","parameters":[{"name":"birds","in":"query","required":true,"description":"Number of birds","schema":{"type":"string"},"example":"10"},{"name":"breed","in":"query","required":false,"description":"bantam, standard, large or heavy","schema":{"type":"string"},"example":"standard"},{"name":"free_range","in":"query","required":false,"description":"true if birds free-range (run = 0)","schema":{"type":"string"},"example":"false"},{"name":"coop_width_ft","in":"query","required":false,"description":"Coop width to get a length","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Rules of thumb: ~4 ft² of coop floor per standard hen (2 for bantams, 5 for heavy breeds) and ~10 ft² of run each. Crowding causes pecking and disease — more space is always better. Free-ranging birds need only the coop to roost in.","inputs":{"birds":10,"breed":"standard","free_range":false},"run_sqft":100,"coop_sqft":40,"total_sqft":140,"run_per_bird_sqft":10,"coop_per_bird_sqft":4},"meta":{"timestamp":"2026-06-06T07:13:59.922Z","request_id":"c7cb5e98-9201-42cd-b71e-58b13c5560ae"},"status":"ok","message":"Coop space","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"US units (ft², inches). Coop ~4 ft²/standard hen + run ~10 ft² each; 1 nest box per 3–4 hens; 8–12\" roost per bird. Rules of thumb — overcrowding causes problems, so round up. For feed quantities or pet nutrition use a different API.","service":"chickencoop-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/space":"Coop and run floor area for a flock by breed size.","GET /v1/fixtures":"Nest boxes, roost length and feeder/waterer space for a flock."},"description":"Backyard-chicken housing maths: coop and run sizing, and flock fixtures (nest boxes, roost, feeder & waterer)."},"meta":{"timestamp":"2026-06-06T07:14:00.019Z","request_id":"a65312f2-0358-441b-b26b-fcea345654bd"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6700,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":422,"monthly_call_quota":56600,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1158,"monthly_call_quota":231500,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3665,"monthly_call_quota":1351000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/chickencoop-api"}