Hebcal

Hebcal REST APIs

Hebcal.com publishes a family of free, public Jewish calendar / Hebrew date / zmanim REST APIs. All endpoints support HTTP and HTTPS (HTTP/2), gzip and brotli…

Data & analytics#calendar

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Hebcal.com publishes a family of free, public Jewish calendar / Hebrew date / zmanim REST APIs. All endpoints support HTTP and HTTPS (HTTP/2), gzip and brotli compression, and HTTP Keep-Alive.

Content generated by these APIs is licensed under a Creative Commons Attribution 4.0 International License.

Reference documentation:

Endpoints 5

Jewish Calendar

  • GETJewish Calendar/hebcal?v=1&cfg=jsonReturns Jewish holidays, candle lighting times, Parashat ha-Shavua, daily learning schedules and more. Date range may be specified by year (with optional…

Hebrew Date Converter

  • GETConvert between Gregorian and Hebrew dates/converter?cfg=jsonFour modes are supported: 1. Gregorian → Hebrew (single date): pass g2h=1 with date=YYYY-MM-DD (or gy/gm/gd). 2. Gregorian → Hebrew (range): pass g2h=1 with…

Zmanim

  • GETHalachic times for a date or range; or check whether a moment is assur bemelacha/zmanim?cfg=jsonTwo modes: 1. Zmanim mode (default): Returns sun-based halachic times for a single date or a start/end range. 2. Assur Melacha mode: Pass im=1 and…

Leyning

  • GETTorah readings for a date or range/leyning?cfg=jsonReturns full kriyah aliyot, haftarah, and (optionally) triennial cycle readings. Use either a single date or both start and end (capped at 180 days).

Yahrzeit

  • POSTYahrzeit, Hebrew birthday and Hebrew anniversary calendar/yahrzeitCalculates the Hebrew anniversary of an event (death, birth, marriage, etc.) for a number of years. HTTPS is required. The body must be…

API details

Base URL
https://www.hebcal.com
Authentication
None declared in the description
Operations
5 operations on 5 pathsGET 4POST 1
Main resources
Hebrew Date Converter 1Jewish Calendar 1Leyning 1Yahrzeit 1Zmanim 1
Response formats
application/json text/calendar text/csv text/xml
Description format
OpenAPI 3.0.3, API version 1.0.0

How to test the Hebcal REST APIs in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Hebcal REST APIs collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Jewish Calendar” (GET /hebcal?v=1&cfg=json), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Hebcal REST APIs?

Hebcal.com publishes a family of free, public Jewish calendar / Hebrew date / zmanim REST APIs. All endpoints support HTTP and HTTPS (HTTP/2), gzip and brotli… It is listed under Data & analytics and has 5 endpoints.

Who publishes the Hebcal REST APIs?

It is listed from Hebcal's public API description (an OpenAPI document), not published by Hebcal on Swastik Codes. Anyone who controls hebcal.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Hebcal REST APIs?

Requests go to https://www.hebcal.com. Endpoint paths are added to this base URL.

How do I authenticate with the Hebcal REST APIs?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the Hebcal REST APIs have?

5 operations on 5 paths (4 GET, 1 POST). The largest groups are Hebrew Date Converter, Jewish Calendar, Leyning, Yahrzeit.

Is forking the Hebcal REST APIs free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.