---
title: "Shuffle and deal a custom deck of arbitrary named cards"
method: POST
path: "/api/tools/game_deck_deal"
---

# Shuffle and deal a custom deck of arbitrary named cards

`POST /api/tools/game_deck_deal`

## Request

- Base URL: `https://tools.moddable.games`
- URL: `https://tools.moddable.games/api/tools/game_deck_deal`
- Auth: none declared

## Request body

- object
  - `cards` object[], required: Cards in the deck (name + optional quantity)
    - `name` string, required
    - `quantity` number
  - `hands` number: Deal into N hands (default: 1 = draw pile only)
  - `per_hand` number: Cards per hand (default: 5)
  - `draw` number: Draw N cards from the top instead of dealing hands

## Response `200`

Tool result

---

[API](https://skmtc.dev/moddable/apis/moddable-games-tools.md) · [All operations](https://skmtc.dev/moddable/apis/moddable-games-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/moddable/apis/moddable-games-tools/revisions/637a0b62cb9a?raw)