---
title: API documentation - Rangers Ba'Kfar
description: Endpoints, authentication, examples, errors, versioning and usage limits for the public read-only JSON API of Rangers Ba'Kfar, a guided off-road tour operator in Daliyat al-Karmel, Israel.
canonical: https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/docs/index.md
last-updated: 2026-10-22
---

# Rangers Ba'Kfar API documentation

The public read-only JSON API of ריינג'רים בכפר (Rangers Ba'Kfar), a family-run guided off-road ranger (buggy) tour operator in Daliyat al-Karmel on the Carmel ridge, Israel.

- Base URL: `https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app`
- Current version: `v1` (base path `/api/v1/`)
- OpenAPI 3.1: [`/openapi.json`](https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/openapi.json)
- Authentication: none - see [`/auth.md`](https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/auth.md)

## Authentication

There is none. Every endpoint is an unauthenticated HTTPS `GET`. The OpenAPI document declares an empty `security` array, which is the machine-readable form of the same statement. No endpoint ever answers `401` or `403`.

## Endpoints

### `GET /api/v1/tours.json` - listTours

Every guided tour with duration, audience, price per vehicle in ILS and seats per vehicle.

```bash
curl https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/api/v1/tours.json
```

```json
{
  "updated": "2026-10-22",
  "apiVersion": "v1",
  "currency": "ILS",
  "priceUnit": "per_vehicle",
  "priceFormula": "total = ceil(people / seatsPerVehicle) * pricePerVehicle",
  "count": 3,
  "pageInfo": { "limit": 100, "cursor": null, "nextCursor": null, "hasNextPage": false },
  "tours": [
    {
      "id": "family-route",
      "nameEn": "Family Route",
      "durationIso8601": "PT1H",
      "pricePerVehicle": 350,
      "seatsPerVehicle": 4
    }
  ]
}
```

Query parameters: `limit` (1-100, default 100) and `cursor` (opaque, from `pageInfo.nextCursor`). The catalog fits in a single page, so `nextCursor` is always `null`.

### `GET /api/v1/site.json` - getSiteProfile

Business profile: description, address and geo, opening hours (including Shabbat), amenities, rating and contact channels.

```bash
curl https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/api/v1/site.json
```

### `GET /api/v1/index.json` - getApiIndex

The endpoint index, pricing model, versioning policy, usage limits and error model.

```bash
curl https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/api/v1/index.json
```

## Pricing model

Pricing is per vehicle, never per person:

```
vehicles = ceil(people / seatsPerVehicle)   # seatsPerVehicle is 4
total    = vehicles * pricePerVehicle
```

| Tour | Price per vehicle (ILS) | 4 people | 6 people |
| --- | --- | --- | --- |
| Family Route | 350 | 350 | 700 |
| Sunset Viewpoints | 450 | 450 | 900 |
| Convoy + meal in nature | 750 | 750 | 1500 |

The full pricing document is [`/pricing.md`](https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/pricing.md).

## Errors

Error bodies follow RFC 9457 problem details and are served as `application/problem+json`:

```json
{
  "type": "https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/docs/index.md#errors",
  "title": "Not Found",
  "status": 404,
  "code": "not_found",
  "detail": "No such resource on this origin.",
  "hint": "Start from /api/v1/index.json or /llms.txt."
}
```

| status | code | when |
| --- | --- | --- |
| 404 | `not_found` | The document does not exist on this origin. |
| 500 | `internal_error` | Transient serving error; retry once after a short delay. |

## Versioning and deprecation

- Versioning strategy: **URL path** - `/api/v1/`.
- The unversioned `/api/tours.json`, `/api/site.json` and `/api/index.json` paths are a legacy alias of `v1`, kept for backwards compatibility.
- A version stays available for at least **12 months** after its successor ships.
- A pending removal is announced in this document and signalled with `Deprecation` and `Sunset` response headers before it happens.

## Usage limits

There is no enforced rate limit; these are static JSON documents served from a CDN. Please poll at most once per hour and use the `updated` field to decide whether a refetch is needed.

## Writes and booking

The API is read-only. A tour request is created either through the booking form on the home page (`/#booking`) or through the in-page WebMCP tool `request_tour_booking`. It is a request, not a confirmed reservation, and no payment is taken online. The operator calls back to confirm the date and the final price.

## Related documents

- [`/llms.txt`](https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/llms.txt) - site-wide agent index
- [`/api/llms.txt`](https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/api/llms.txt) - API section index
- [`/.well-known/api-catalog`](https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/.well-known/api-catalog) - RFC 9727 linkset
- [`/.well-known/agent-skills/index.json`](https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/.well-known/agent-skills/index.json) - Agent Skills index
