{"openapi":"3.1.0","info":{"title":"Equine Care API","version":"1.0.0","description":"Horse-care maths as an API, computed locally and deterministically — the everyday numbers a horse owner, barn manager or vet tech runs without reaching for a chart. The weight endpoint estimates body weight from a weight-tape measurement using the classic formula weight ≈ heart girth² × body length ÷ a type divisor (adult 330, yearling 301, weanling 280, pony 299) with measurements in inches — a horse with a 72-inch girth and 66-inch length comes out at about 1,037 lb (470 kg), the number you actually dose wormer and feed against. The feed endpoint turns body weight and a goal into daily forage: horses eat roughly 1.5–2.5 % of body weight in dry-matter forage a day, so a 1,000 lb horse on maintenance wants about 15–20 lb of hay, more to gain and less to slim. The gestation endpoint gives the foaling due date and the normal 320–362 day window from a breeding date — a mare bred on 1 April is due around 7 March the next year, give or take three weeks. Everything is computed locally and deterministically, so it is instant and private. Ideal for barn-management and horse-care apps, breeding and foaling trackers, feed-calculator and tack-shop sites, and equine-vet tools. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 compute endpoints. Educational estimates — not veterinary advice.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/equine-api","description":"oanor gateway"}],"tags":[{"name":"Equine"},{"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/feed":{"get":{"operationId":"get_v1_feed","tags":["Equine"],"summary":"Daily forage by body weight","description":"","parameters":[{"name":"body_weight_lb","in":"query","required":true,"description":"Body weight in pounds","schema":{"type":"string"},"example":"1000"},{"name":"goal","in":"query","required":false,"description":"maintenance | light_work | weight_gain | weight_loss","schema":{"type":"string"},"example":"maintenance"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Horses eat roughly 1.5–2.5 % of body weight in dry-matter forage a day, with hay as the base of the diet — a 1,000 lb horse on maintenance wants about 15–20 lb of hay. Make all feed changes gradually over 7–10 days, keep forage in front of them, and add concentrates only to fill the gap forage can't.","inputs":{"goal":"maintenance","body_weight_lb":1000},"forage_lb_max":20,"forage_lb_min":15,"total_intake_lb":20},"meta":{"timestamp":"2026-06-06T15:30:46.710Z","request_id":"4ec579dd-5800-4a39-8153-80eedbee4764"},"status":"ok","message":"Daily forage","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/gestation":{"get":{"operationId":"get_v1_gestation","tags":["Equine"],"summary":"Foaling due date","description":"","parameters":[{"name":"breeding_date","in":"query","required":true,"description":"Breeding date (YYYY-MM-DD)","schema":{"type":"string"},"example":"2026-04-01"},{"name":"gestation_days","in":"query","required":false,"description":"Average gestation days (default 340)","schema":{"type":"string"},"example":"340"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Mare gestation averages about 340 days but a healthy range is roughly 320–362 days, so treat the due date as the middle of a window, not a deadline. Watch for waxing, udder fill and softening near term, and have the vet's number ready — most mares foal at night, quickly.","inputs":{"breeding_date":"2026-04-01","gestation_days":340},"due_date":"2027-03-07","window_late":"2027-03-29","window_early":"2027-02-15"},"meta":{"timestamp":"2026-06-06T15:30:46.808Z","request_id":"6eb9cd63-914d-4946-b2f1-0e5b73279472"},"status":"ok","message":"Foaling due date","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/weight":{"get":{"operationId":"get_v1_weight","tags":["Equine"],"summary":"Body weight from a weight tape","description":"","parameters":[{"name":"heart_girth_in","in":"query","required":true,"description":"Heart girth in inches","schema":{"type":"string"},"example":"72"},{"name":"body_length_in","in":"query","required":true,"description":"Body length in inches","schema":{"type":"string"},"example":"66"},{"name":"type","in":"query","required":false,"description":"adult | yearling | weanling | pony | draft","schema":{"type":"string"},"example":"adult"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Weight ≈ heart girth² × body length ÷ a type divisor (adult 330, yearling 301, weanling 280, pony 299) with measurements in inches. Measure the girth snugly behind the withers/elbow and the length from point of shoulder to point of buttock. A weight tape is a handy field estimate; a livestock scale is the gold standard for dosing.","inputs":{"type":"adult","body_length_in":66,"heart_girth_in":72},"weight_kg":470,"weight_lb":1037},"meta":{"timestamp":"2026-06-06T15:30:46.903Z","request_id":"1d9b7a10-0745-4488-98b4-bbd1b731bec2"},"status":"ok","message":"Body weight","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":"Weight = girth²×length ÷ divisor (inches); forage 1.5–2.5 % of body weight/day; gestation ≈ 340 days (320–362 window). Educational estimates — not veterinary advice; weigh and worm to the vet's guidance.","service":"equine-api","endpoints":{"GET /v1/feed":"Daily forage and total intake from body weight and goal.","GET /v1/meta":"This document.","GET /v1/weight":"Body weight from heart girth and body length (weight-tape formula).","GET /v1/gestation":"Foaling due date and window from a breeding date."},"description":"Equine-care maths: body weight from a weight-tape measurement, daily forage by body weight, and the foaling due date from a breeding date."},"meta":{"timestamp":"2026-06-06T15:30:46.990Z","request_id":"460071e0-7360-4bf8-a384-035b89ffe03b"},"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":350,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":575,"monthly_call_quota":8500,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1850,"monthly_call_quota":55000,"rps_limit":13,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5450,"monthly_call_quota":195000,"rps_limit":33,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/equine-api"}