Skip to content
InterlineaDocs
REST APIPassagesDocs menu

Passages

The graded path.

GET/api/v1/passages

The curated passages for learners, levels 1 to 5, in reading order.

Parameters

Parameters
NameDescription
langstringOptionalOnly this language.

One of la, grc, latin, greek.

levelintegerOptionalOnly this level.

From 1 to 5.

Response

200 OK with a PassageList object.

Response fields
NameDescription
notestring
passagesarray of PassageSummaryThe graded path, easiest first within each language.
11 fields
passages fields
slugstring
langstringLanguage code: la (Latin) or grc (Ancient Greek).

One of la, grc.

levelinteger1 (easiest) to 5.
titlestring
citationstring
verseboolean
wordsinteger
blurbstring
urnstring or nullCTS URN, e.g. urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.1-1.11. Null when the edition has none (The Latin Library's own numbering).
urlstringAbsolute URL.
apistringAbsolute URL.

Errors

StatusWhen
400 Bad RequestA parameter is missing or invalid, or the reference isn't a text.
429 Too Many RequestsToo many requests from one address. Wait a minute.
500 Internal Server ErrorSomething went wrong on our side.

Error bodies are described in Caching, limits and errors.

Example request

curl "https://interlinea.aeterna-institute.org/api/v1/passages"

Example response

Response200 OK
{
  "note": "The graded path: short passages chosen and ordered for learners, each analysed ahead of time. Read them in order within a language.",
  "passages": [
    {
      "slug": "genesis-creation",
      "lang": "la",
      "level": 1,
      "title": "Let There Be Light",
      "citation": "Vulgate (Jerome), Genesis 1.1–5",
      "verse": false,
      "words": 58,
      "blurb": "Creation’s first day in plain, rhythmic Church Latin.",
      "urn": null,
      "url": "https://interlinea.aeterna-institute.org/read/latin/genesis-creation",
      "api": "https://interlinea.aeterna-institute.org/api/v1/passages/latin/genesis-creation"
    },
    {
      "slug": "ritchie-perseus-ark",
      "lang": "la",
      "level": 1,
      "title": "The Ark on the Sea",
      "citation": "Francis Ritchie, Fabulae Faciles, Perseus 1",
      "verse": false,
      "words": 62,
      "blurb": "A baby hero, a fearful grandfather, a chest cast adrift.",
      "urn": null,
      "url": "https://interlinea.aeterna-institute.org/read/latin/ritchie-perseus-ark",
      "api": "https://interlinea.aeterna-institute.org/api/v1/passages/latin/ritchie-perseus-ark"
    },
    {
      "slug": "phaedrus-wolf-lamb",
      "lang": "la",
      "level": 2,
      "title": "The Wolf and the Lamb",
      "citation": "Phaedrus, Fabulae 1.1",
      "verse": true,
      "words": 91,
      "blurb": "Aesop’s grimmest fable. The strong always find an excuse.",
      "urn": "urn:cts:latinLit:phi0975.phi001.perseus-lat2:1.1",
      "url": "https://interlinea.aeterna-institute.org/read/latin/phaedrus-wolf-lamb",
      "api": "https://interlinea.aeterna-institute.org/api/v1/passages/latin/phaedrus-wolf-lamb"
    },
    // 23 more
  ]
}
Cache-Control: public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800

Try it

Send a real GET from your browser and see the answer, its status and how long it took.

GET /api/v1/passages