Reference / Provenance

Liturgical explanation

See the precedence applied, the transfers, and where each reading returned for a date came from.

Checking where the response came from

The response gathers the day's context, the candidate celebrations, the transfers, the colour and the origin of each reading. Use this endpoint to show which rule and which table produced the result.

GET/api/v1/liturgical_explanation/:year/:month/:day

Example request

curl -G "https://api.caminhoanglicano.com.br/api/v1/liturgical_explanation/2026/03/25" \
  -H "X-API-Key: estevao_sua_chave" \
  --data-urlencode 'preferences={"prayer_book_code":"loc_1662_en","lectionary_variant":"revised_1922"}' \
  --data-urlencode 'locale=en-US' \
  --data-urlencode 'service_type=morning_prayer'

What changes with the BCP 1662

When a prayer book declares alternative tables, the response carries the variant used in the guide and in each reading. An application can then say plainly whether the selection came from the original 1662 table, the 1871 revision or the optional 1922 revision.

Response excerpt200 OK

{
  "data": {
    "date": "2026-03-25",
    "prayer_book_code": "loc_1662_en",
    "reading_guide": {
      "lectionary": {
        "code": "revised_1922",
        "label": "Optional revised 1922"
      }
    },
    "readings": [
      {
        "slot": "first_reading",
        "reference": "Isaiah 52:7-12",
        "service_type": "morning_prayer",
        "lectionary_variant": "revised_1922",
        "lectionary_variant_label": "Optional revised 1922"
      }
    ]
  },
  "meta": { "contract_version": 1 }
}

Parameters

Parameter	Values	Description
preferences	JSON	Required; send at least prayer_book_code. For the BCP 1662, add lectionary_variant.
locale	en-US · es · pt-BR · pt-PT · cy	The language of the explanation's messages and labels.
service_type	eucharist · morning_prayer · evening_prayer	Restricts the explanation to the chosen service.