Akathists Endpoint

Get akathists for a saint by internal id. Each akathist is a sequence of numbered kondaks and ikoses, with optional closing prayers.

Request

GET /akathists/?id=442

GET /akathists/?id=442&lang=cu&number=2

Parameters:

Parameter	Type	In	Description
`id`	string	query	Internal saint id (typically one). Example: `?id=442`.
`lang`	string	query	`ru` (default), `cu`, or `en`. Unknown values fall back to `ru`.
`number`	integer	query	Optional. Selects a specific akathist by its internal number.

Validation:

each id length: 1..128, pattern ^[A-Za-z0-9_][A-Za-z0-9._:-]{0,127}$;
number (when present) must be a single positive integer; 0, negatives, decimals, non-numeric, or repeated values return 400.

Response

Returns an ordered array in data.

found=true: akathists payload for this id.
found=false: empty akathists + notFound object (id unknown, no data for the language, or the requested number was not found).

{
  "meta": {
    "lang": "ru",
    "format": "html",
    "requestedIds": ["442"],
    "count": 1
  },
  "data": [
    {
      "id": "442",
      "found": true,
      "akathists": [
        {
          "number": 1,
          "title": "Акафист преподобному Амвросию Оптинскому",
          "sections": [
            { "type": "kondak", "number": 1, "html": "<p>...</p>" },
            { "type": "ikos", "number": 1, "html": "<p>...</p>" }
          ],
          "repeatEnding": true,
          "prayers": [
            { "html": "<p>...</p>" }
          ]
        }
      ]
    }
  ]
}

Notes

number is a stable per-saint selector: a saint may have several akathists, each with a unique number. Use ?number=N to fetch a specific one; omit it to get all.
sections[] holds the body in printed order: standard akathists have 13 kondaks + 12 ikoses alternating, starting with kondak 1. sections[].number is the part number.
repeatEnding: true signals that, after kondak 13, ikos 1 and kondak 1 are repeated verbatim at the end. These are not duplicated in the data — the client re-inserts them from sections.
prayers[] (optional) holds one or more closing prayers, each with sanitized html and an optional plain-text title.
html fields are sanitized HTML with allowlisted tags only: p, br, h2, h3, ul, ol, li, strong, em, and safe internal footnote anchors via a.
Languages: ru and cu are always available; en is optional and may be empty for now — lang=en returns found=false until English texts are added.