---
title: "Generate a combat encounter (free, SRD monsters only)"
method: POST
path: "/v1/tools/dnd/encounter"
tags: ["DnD Tools"]
---

# Generate a combat encounter (free, SRD monsters only)

`POST /v1/tools/dnd/encounter`

## Request

- Base URL: `https://api.sprixen.com`
- URL: `https://api.sprixen.com/v1/tools/dnd/encounter`
- Auth: `bearer` (a scheme the document does not define)

## Request body

- CreateDndEncounterDto
  - `partyLevel` number, required
  - `partySize` number, required
  - `difficulty` 'easy' | 'medium' | 'hard' | 'deadly'
  - `environment` string
  - `theme` string

## Response `200`

Encounter result

## Other responses

- `429`: Daily free-text limit reached

---

[API](https://skmtc.dev/sprixen/apis/sprixen-api.md) · [All operations](https://skmtc.dev/sprixen/apis/sprixen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sprixen/apis/sprixen-api/revisions/6c0c57f6da58?raw)