---
title: "Random beyt from the Masnavi"
method: GET
path: "/api/random"
tags: ["rest"]
---

# Random beyt from the Masnavi

`GET /api/random`

## Request

- Base URL: `https://masnavi.ai`
- URL: `https://masnavi.ai/api/random`
- Auth: none declared

Returns a randomly-selected beyt, optionally restricted to a daftar.

## Query parameters

- `daftar` integer, nullable: Restrict to one daftar.

## Response `200`

Successful Response

- Beyt
  - `citation` string, required: Canonical citation, e.g. 'M3:1278'
  - `daftar` integer, required
  - `beyt_in_daftar` integer, required
  - `beyt_global` integer, required
  - `mesra1` string, required: First hemistich (with diacritics)
  - `mesra2` string, required: Second hemistich
  - `section_id` integer, required
  - `section_title` string, required
  - `section_slug` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/masnavi/apis/masnavi-ai.md) · [All operations](https://skmtc.dev/masnavi/apis/masnavi-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/masnavi/apis/masnavi-ai/revisions/2622163d327c?raw)