The Kosher API

What it is

A read-only REST API over the same dataset that powers thekosher.app. Filter directory records by city, country, distance, venue type, cuisine and recorded agency. Keep those records distinct from reviewed current certification and opening hours. Interpret natural-language preferences with one endpoint.

Use cases

• 🛎

  Hotel & hospitality concierge

  In-room recommendations, post-checkin guides, kosher-only itineraries.

• ✈

  Travel booking platforms

  Surface kosher availability inside destination, hotel, and itinerary search.

• 🕍

  Jewish community apps

  Embed the directory inside your member experience without re-building it.

• 🍱

  Corporate catering platforms

  Find vendor listings and review available agency records.

• 🚲

  Food delivery services

  Find directory listings with recorded agencies; confirm current status independently.

• 📅

  Event planning software

  Match venues to dietary needs across cities, hashgachos, and price tiers.

Code example

Authenticate with a bearer token and pass any of the structured filters as query params.

curl https://thekosher.app/api/v1/restaurants \
  -H 'Authorization: Bearer tk_live_xxxxxxxx' \
  -G --data-urlencode 'city=Brooklyn' --data-urlencode 'type=meat'

Illustrative response excerpt · synthetic venue

{
  "data": [
    {
      "id": "...",
      "slug": "kosher-deli-brooklyn",
      "name": "Kosher Deli",
      "type": "MEAT",
      "price_range": 2,
      "cuisine": "Deli",
      "location": { "city": "Brooklyn", "country_code": "US", "latitude": 40.62, "longitude": -73.96 },
      "recorded_agencies": [{ "slug": "example", "name": "Example agency", "abbreviation": "EX", "state": "recorded_unreviewed" }],
      "certification": { "state": "unknown", "reason": "Named agency evidence required" },
      "availability": { "state": "unknown", "reason": "Reviewed schedule projection unavailable" }
    }
  ],
  "pagination": { "limit": 25, "offset": 0, "total": 1, "has_more": false }
}

Pricing

Plans are quoted when access is granted. Confirm pricing, quota and support terms before using the API in production.

FAQ

How fresh is the data?

Directory metadata and current evidence are separate. Preserve the source, review, validity and state supplied by each scoped assertion. Missing or expired evidence cannot establish current certification or availability; a recent API fetch does not refresh the underlying evidence.

What certifications are covered?

The /certifications endpoint lists active agency directory records. A venue’s recorded_agencies field is historical directory metadata. Current named certification requires eligible reviewed evidence for the same venue, location and applicable season.

Is global coverage included?

Yes. The Kosher indexes listed establishments worldwide — Israel, the US, Canada, the UK, France, Argentina, Australia and beyond. There's no per-country gating; one key serves the full dataset. "Listed" means an editor admitted the venue to the directory, not that anyone independently checked its kashrus.

Can I get webhook updates?

Webhooks and updated_since filtering are unavailable. Use the documented pagination and structured filters. Contact us to discuss an integration requirement; availability is confirmed separately.