---
title: "Look up a specific beyt by citation"
method: GET
path: "/api/lookup"
tags: ["rest"]
---

# Look up a specific beyt by citation

`GET /api/lookup`

## Request

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

Fetch a beyt by its canonical citation (e.g. 'M3:1278' = Daftar 3 beyt 1278), or by daftar+beyt_in_daftar, or by global index. Optionally include surrounding beyts for context.

## Query parameters

- `citation` string, nullable: Citation, e.g. 'M3:1278' or 'g:7421'.
- `daftar` integer, nullable: Daftar number 1-6 (use with beyt_in_daftar).
- `beyt_in_daftar` integer, nullable: 1-based beyt index within the daftar.
- `beyt_global` integer, nullable: Global beyt index 1..25635.
- `before` integer: Beyts of context before.
- `after` integer: Beyts of context after.

## Response `200`

Successful Response

- LookupResponse
  - `primary` Beyt, required
    - `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
  - `context_before` 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
  - `context_after` 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)