Skip to content

Using the API on your website

Jump to bottom
John R. D'Orazio edited this page Apr 24, 2026 · 4 revisions

Using the API on your website

The Liturgical Calendar API provides liturgical calendar data that can be displayed on any website. The easiest way to get started is through one of the official component libraries, which handle API communication and UI rendering.

Component libraries

JavaScript (NPM)

The liturgy-components-js package provides ES6 module components for building liturgical calendar interfaces in the browser:

  • WebCalendar — renders a full liturgical calendar as an HTML table
  • LiturgyOfTheDay — displays today's liturgical events
  • LiturgyOfAnyDay — look up the liturgy for any date (with date picker controls)
  • CalendarSelect — dropdown to choose between available national and diocesan calendars
  • ApiOptions — UI controls for configuring API request parameters
  • ApiClient — handles API requests and content negotiation

Install via NPM or Yarn:

npm install liturgy-components-js

See the package README for installation, usage examples, and the full component API.

PHP (Composer)

The liturgy-components-php package provides server-side PHP components:

  • WebCalendar — renders a liturgical calendar as an HTML table
  • CalendarSelect — generates a <select> element for choosing calendars
  • ApiOptions — generates form controls for API parameters

Install via Composer:

composer require liturgical-calendar/components

See the package README for installation, usage examples, and the full component API.

Interactive exploration

The usage page provides an interactive overview of the API, including calendar subscription URLs, request parameter configuration, and live previews.

Liturgy of any Day

A ready-made page for looking up the liturgy on any given date is available at https://litcal.johnromanodorazio.com/liturgyOfAnyDay.php. This page is built with the liturgy-components-js library and can serve as a reference implementation.

Alexa skill

An Amazon Alexa newsbrief skill that reads the Liturgy of the Day is available at https://github.com/Liturgical-Calendar/AmazonAlexa-newsbrief.

Navigation

For Users

For Webmasters

For Liturgists

For Developers

For Contributors

Testing

Authentication & RBAC

Clone this wiki locally