{"openapi":"3.1.0","info":{"title":"Yahtzee Score API","version":"1.0.0","description":"Yahtzee scoring maths as an API, computed locally and deterministically — the category scores and totals a dice-game scoring app runs on. (It scores a given roll; it does not roll the dice.) The score endpoint takes five dice and returns the value of every one of the thirteen boxes at once: the upper boxes (ones through sixes) score the sum of that number, three- and four-of-a-kind and chance score all five dice, a full house is 25, a small straight (four in a row) 30, a large straight (five in a row) 40 and a Yahtzee (five of a kind) 50 — so 3-3-3-5-6 is worth 20 in three-of-a-kind, 4-4-4-5-5 is a 25-point full house, and it flags the highest-scoring box for you. The total endpoint adds up a finished card: the 35-point upper-section bonus when the upper boxes reach 63 (and how many points you still need for it), plus 100 for each extra Yahtzee, to give the grand total. Everything is computed locally and deterministically, so it is instant and private. Ideal for dice-game, board-game-companion, family-game and scorekeeping app developers, score-sheet and tournament tools, and game software. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 2 compute endpoints. For random rolls use a dice API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/yahtzee-api","description":"oanor gateway"}],"tags":[{"name":"Yahtzee"},{"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/score":{"get":{"operationId":"get_v1_score","tags":["Yahtzee"],"summary":"Score five dice","description":"","parameters":[{"name":"dice","in":"query","required":true,"description":"Five dice 1–6","schema":{"type":"string"},"example":"3,3,3,5,6"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Every category's value for this roll. Upper boxes score the sum of that face; 3/4-of-a-kind and chance score all five dice; full house 25, small straight 30, large straight 40, Yahtzee 50. Pick the box that's worth most — or save a category for later.","inputs":{"dice":[3,3,3,5,6]},"scores":{"ones":0,"twos":0,"fives":5,"fours":0,"sixes":6,"chance":20,"threes":9,"yahtzee":0,"full_house":0,"four_of_a_kind":0,"large_straight":0,"small_straight":0,"three_of_a_kind":20},"best_score":20,"best_category":"three_of_a_kind"},"meta":{"timestamp":"2026-06-06T07:13:56.184Z","request_id":"3808249c-f46f-4090-a243-ebc9014fe888"},"status":"ok","message":"Score roll","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/total":{"get":{"operationId":"get_v1_total","tags":["Yahtzee"],"summary":"Bonus + grand total","description":"","parameters":[{"name":"upper_total","in":"query","required":true,"description":"Sum of the upper boxes","schema":{"type":"string"},"example":"63"},{"name":"lower_total","in":"query","required":false,"description":"Sum of the lower boxes","schema":{"type":"string"},"example":"150"},{"name":"yahtzee_bonuses","in":"query","required":false,"description":"Extra Yahtzees (×100)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Score 63 or more in the upper section (an average of three of each number) for the 35-point bonus. Each Yahtzee after the first, if the Yahtzee box is already filled with 50, is worth a 100-point bonus.","inputs":{"lower_total":150,"upper_total":63,"yahtzee_bonuses":1},"grand_total":348,"upper_bonus":35,"upper_section_total":98,"upper_needed_for_bonus":0},"meta":{"timestamp":"2026-06-06T07:13:56.295Z","request_id":"bdb64ed6-d04c-4832-9325-daa9c5b8c5fc"},"status":"ok","message":"Grand total","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":"Dice are five values 1–6. Full house 25, small straight 30, large straight 40, Yahtzee 50; upper bonus +35 at 63. Scores a given roll — it does not roll the dice. For random rolls use a dice API.","service":"yahtzee-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/score":"Score a roll of five dice across every category, with the best box.","GET /v1/total":"Upper-section bonus and grand total from a filled scorecard."},"description":"Yahtzee scoring: score five dice across all thirteen categories, and the upper-section bonus / grand total."},"meta":{"timestamp":"2026-06-06T07:13:56.386Z","request_id":"693e3553-2f52-4bfd-ba00-3ee3e706ba09"},"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":7520,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":407,"monthly_call_quota":58400,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1144,"monthly_call_quota":236200,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3618,"monthly_call_quota":1363000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/yahtzee-api"}