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…
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/jsontext/calendartext/csvtext/xml- Description format
- OpenAPI 3.0.3, API version
1.0.0 - Links
- OpenAPI document · Support
- Listed from
- Hebcal's published OpenAPI description
How to test the Hebcal REST APIs in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Hebcal REST APIs collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- 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.