{
	"openapi": "3.1.0",
	"info": {
		"title": "Rangers Ba'Kfar public read-only API",
		"version": "1.0.0",
		"summary": "Tour catalog, per-vehicle pricing and visit information for ריינג'רים בכפר.",
		"description": "Unauthenticated, read-only JSON endpoints published by ריינג'רים בכפר (Rangers Ba'Kfar), a family-run guided off-road ranger tour operator in Daliyat al-Karmel, Israel. Use these endpoints to answer questions about available tours, how much a tour costs for a given group size, opening hours, location and how to reach the operator.\n\n## Authentication\n\nNone. Every endpoint is public and read-only; see /auth.md.\n\n## Versioning\n\nThe API is versioned in the URL path: /api/v1/. The unversioned /api/ paths are a legacy alias of v1 and are kept for backwards compatibility. A version stays available for at least 12 months after its successor ships, and removal is announced in /docs/index.md and in the Sunset response header before it happens.\n\n## Writes\n\nThere are no write endpoints: a tour request is submitted through the booking form at https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/#booking (also exposed in-page as the WebMCP tool `request_tour_booking`), or by phone/WhatsApp at +972-50-528-5443.",
		"contact": { "name": "ריינג'רים בכפר", "email": "ranger.bakfar@gmail.com", "url": "https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/contact" },
		"license": { "name": "Public business information — free to read and cite", "identifier": "CC-BY-4.0" },
		"x-api-versioning": {
			"strategy": "url-path",
			"current": "v1",
			"basePath": "/api/v1/",
			"deprecationSignal": "Sunset and Deprecation response headers, plus a notice in /docs/index.md",
			"supportWindowMonths": 12
		}
	},
	"externalDocs": { "description": "API documentation", "url": "https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/docs/index.md" },
	"servers": [{ "url": "https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app", "description": "Production" }],
	"security": [],
	"tags": [
		{ "name": "tours", "description": "Tour catalog and pricing" },
		{ "name": "business", "description": "Opening hours, location and contact channels" }
	],
	"paths": {
		"/api/v1/tours.json": {
			"get": {
				"operationId": "listTours",
				"tags": ["tours"],
				"summary": "List all guided tours",
				"description": "Returns every tour with its duration, intended audience, price per vehicle in ILS and the number of passengers one vehicle seats. Compute a total with ceil(people / seatsPerVehicle) * pricePerVehicle. The response carries a `pageInfo` object; the whole catalog fits in one page, so `nextCursor` is always null.",
				"parameters": [
					{ "$ref": "#/components/parameters/Limit" },
					{ "$ref": "#/components/parameters/Cursor" }
				],
				"responses": {
					"200": {
						"description": "The full tour catalog.",
						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/TourCatalog" } } }
					},
					"404": { "$ref": "#/components/responses/NotFound" },
					"500": { "$ref": "#/components/responses/ServerError" }
				}
			}
		},
		"/api/v1/site.json": {
			"get": {
				"operationId": "getSiteProfile",
				"tags": ["business"],
				"summary": "Get the business profile",
				"description": "Returns the business description, address, opening hours (including Shabbat), amenities, rating and contact channels.",
				"responses": {
					"200": {
						"description": "Business profile.",
						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SiteProfile" } } }
					},
					"404": { "$ref": "#/components/responses/NotFound" },
					"500": { "$ref": "#/components/responses/ServerError" }
				}
			}
		},
		"/api/v1/index.json": {
			"get": {
				"operationId": "getApiIndex",
				"tags": ["business"],
				"summary": "List the available endpoints",
				"description": "Machine-readable index of every public endpoint, with the pricing model, the versioning policy, usage limits and the error model.",
				"responses": {
					"200": {
						"description": "Endpoint index.",
						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiIndex" } } }
					},
					"404": { "$ref": "#/components/responses/NotFound" },
					"500": { "$ref": "#/components/responses/ServerError" }
				}
			}
		}
	},
	"components": {
		"parameters": {
			"Limit": {
				"name": "limit",
				"in": "query",
				"required": false,
				"description": "Maximum number of tours to return. The catalog is small enough that every request returns the full list.",
				"schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 100 }
			},
			"Cursor": {
				"name": "cursor",
				"in": "query",
				"required": false,
				"description": "Opaque cursor taken from `pageInfo.nextCursor` of a previous response. Always null today, because the catalog fits in one page.",
				"schema": { "type": "string" }
			}
		},
		"responses": {
			"NotFound": {
				"description": "The requested resource does not exist on this origin.",
				"content": {
					"application/problem+json": {
						"schema": { "$ref": "#/components/schemas/Problem" },
						"example": {
							"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."
						}
					}
				}
			},
			"ServerError": {
				"description": "Unexpected error while serving the document.",
				"content": {
					"application/problem+json": {
						"schema": { "$ref": "#/components/schemas/Problem" },
						"example": {
							"type": "https://copy-of-elegant-business-presence-redesign-qtzywh.sticklight.app/docs/index.md#errors",
							"title": "Internal Server Error",
							"status": 500,
							"code": "internal_error",
							"detail": "The document could not be served. Retry later.",
							"hint": "Retry once after a short delay, then contact ranger.bakfar@gmail.com."
						}
					}
				}
			}
		},
		"schemas": {
			"Tour": {
				"type": "object",
				"description": "One guided off-road tour.",
				"required": ["id", "name", "pricePerVehicle", "seatsPerVehicle"],
				"properties": {
					"id": { "type": "string", "description": "Stable slug for the tour.", "examples": ["family-route"] },
					"name": { "type": "string", "description": "Hebrew name as shown on the site." },
					"nameEn": { "type": "string", "description": "English name." },
					"description": { "type": "string", "description": "Hebrew description." },
					"descriptionEn": { "type": "string", "description": "English description." },
					"durationIso8601": { "type": "string", "description": "Duration as an ISO 8601 period.", "examples": ["PT1H30M"] },
					"durationText": { "type": "string", "description": "Human-readable duration in Hebrew." },
					"audience": { "type": "string", "description": "Who the tour suits." },
					"pricePerVehicle": { "type": "number", "description": "List price in ILS for one vehicle.", "examples": [350] },
					"seatsPerVehicle": { "type": "integer", "description": "Maximum passengers in one vehicle.", "examples": [4] },
					"availability": { "type": "string", "description": "Schema.org availability URL." }
				}
			},
			"PageInfo": {
				"type": "object",
				"description": "Cursor pagination envelope. The catalog fits in one page, so nextCursor is always null.",
				"required": ["limit", "hasNextPage"],
				"properties": {
					"limit": { "type": "integer", "examples": [100] },
					"cursor": { "type": ["string", "null"], "description": "Cursor used for this request." },
					"nextCursor": { "type": ["string", "null"], "description": "Cursor for the next page, or null when there is none." },
					"hasNextPage": { "type": "boolean", "examples": [false] },
					"note": { "type": "string" }
				}
			},
			"BookingInfo": {
				"type": "object",
				"description": "How a tour request is made. There is no online payment.",
				"properties": {
					"form": { "type": "string", "format": "uri" },
					"phone": { "type": "string", "examples": ["+972505285443"] },
					"whatsapp": { "type": "string", "format": "uri" },
					"payment": { "type": "string" },
					"note": { "type": "string" }
				}
			},
			"TourCatalog": {
				"type": "object",
				"description": "The full tour catalog with the pricing model and a pagination envelope.",
				"required": ["currency", "tours"],
				"properties": {
					"updated": { "type": "string", "format": "date" },
					"apiVersion": { "type": "string", "examples": ["v1"] },
					"currency": { "type": "string", "examples": ["ILS"] },
					"priceUnit": { "type": "string", "examples": ["per_vehicle"] },
					"priceFormula": { "type": "string" },
					"count": { "type": "integer" },
					"pageInfo": { "$ref": "#/components/schemas/PageInfo" },
					"tours": { "type": "array", "items": { "$ref": "#/components/schemas/Tour" } },
					"booking": { "$ref": "#/components/schemas/BookingInfo" }
				}
			},
			"OpeningHoursRow": {
				"type": "object",
				"properties": {
					"days": { "type": "string", "examples": ["Sunday-Thursday"] },
					"opens": { "type": "string", "examples": ["09:00"] },
					"closes": { "type": "string", "examples": ["20:00"] }
				}
			},
			"SiteProfile": {
				"type": "object",
				"description": "Business profile: who the operator is, where it is and how to reach it.",
				"properties": {
					"updated": { "type": "string", "format": "date" },
					"business": { "type": "object", "additionalProperties": true },
					"location": { "type": "object", "additionalProperties": true },
					"openingHours": { "type": "array", "items": { "$ref": "#/components/schemas/OpeningHoursRow" } },
					"amenities": { "type": "array", "items": { "type": "string" } },
					"rating": { "type": "object", "additionalProperties": true },
					"contact": { "type": "object", "additionalProperties": true }
				}
			},
			"ApiEndpoint": {
				"type": "object",
				"required": ["operationId", "method", "url"],
				"properties": {
					"operationId": { "type": "string", "examples": ["listTours"] },
					"method": { "type": "string", "examples": ["GET"] },
					"url": { "type": "string", "format": "uri" },
					"description": { "type": "string" }
				}
			},
			"ApiIndex": {
				"type": "object",
				"description": "Index of every public endpoint, with the pricing model, versioning policy, usage limits and error model.",
				"required": ["name", "endpoints"],
				"properties": {
					"name": { "type": "string" },
					"description": { "type": "string" },
					"apiVersion": { "type": "string", "examples": ["v1"] },
					"version": { "type": "string", "examples": ["1.0.0"] },
					"updated": { "type": "string", "format": "date" },
					"openapi": { "type": "string", "format": "uri" },
					"documentation": { "type": "string", "format": "uri" },
					"authentication": { "type": "object", "additionalProperties": true },
					"versioning": { "type": "object", "additionalProperties": true },
					"usageLimits": { "type": "object", "additionalProperties": true },
					"endpoints": { "type": "array", "items": { "$ref": "#/components/schemas/ApiEndpoint" } },
					"pricingModel": { "type": "object", "additionalProperties": true },
					"errorModel": { "type": "object", "additionalProperties": true }
				}
			},
			"Problem": {
				"type": "object",
				"description": "RFC 9457 problem details, returned as application/problem+json for every 4xx and 5xx response.",
				"required": ["title", "status", "code"],
				"properties": {
					"type": { "type": "string", "format": "uri", "description": "URI identifying the problem type." },
					"title": { "type": "string", "examples": ["Not Found"] },
					"status": { "type": "integer", "examples": [404] },
					"detail": { "type": "string", "description": "Human-readable explanation." },
					"code": { "type": "string", "description": "Stable machine-readable error code.", "examples": ["not_found"] },
					"hint": { "type": "string", "description": "What the agent should do next." }
				}
			}
		}
	}
}
