Get Experience Provider

Endpoint

GET /experiences/:id

Description

Retrieve full details for an experience provider, including all their locations, active offerings, and current specials.

Authentication

No authentication required. This is a public endpoint.

Path Parameters

Parameter	Type	Description
`id`	string	Provider ID (UUID)

Example Request

curl "https://charter.boats/api/experiences/e5f6a7b8-1234-5678-abcd-ef0123456789"

Example Response

{
  "id": "e5f6a7b8-...",
  "business_name": "Ionian Dive Center",
  "business_type": "dive_shop",
  "description": "Premier dive shop on Lefkada since 2010.",
  "logo_url": "https://example.com/logo.png",
  "website": "https://ioniandive.com",
  "phone": "+30 2645 012345",
  "email": "info@ioniandive.com",
  "is_verified": true,
  "is_active": true,
  "created_at": "2026-01-15T10:00:00Z",
  "locations": [
    {
      "id": "a1b2c3d4-...",
      "name": "Lefkas Marina Dock",
      "latitude": 38.8340,
      "longitude": 20.7065,
      "offerings": [
        {
          "id": "c9d0e1f2-...",
          "title": "Reef Snorkeling Tour",
          "description": "3-hour guided snorkeling tour",
          "category": "tour",
          "duration_minutes": 180,
          "price_from": 65,
          "price_to": 65,
          "is_active": true,
          "specials": [
            {
              "id": "d1e2f3a4-...",
              "title": "Early Season Deal",
              "description": "Book before June",
              "discount_percent": 15,
              "valid_from": "2026-04-01",
              "valid_to": "2026-05-31",
              "is_active": true
            }
          ]
        }
      ]
    }
  ]
}

Response Fields

Field	Type	Description
`id`	string	Provider ID
`business_name`	string	Business name
`business_type`	string	Type of business
`description`	string\|null	Business description
`logo_url`	string\|null	Logo image URL
`website`	string\|null	Website URL
`phone`	string\|null	Contact phone
`email`	string\|null	Contact email
`is_verified`	boolean	Verified status
`is_active`	boolean	Whether the provider is active
`locations`	array	All locations for this provider
`locations[].offerings`	array	Active offerings at each location
`locations[].offerings[].specials`	array	Currently valid specials/promotions
`locations[].offerings[].specials[].discount_percent`	number	Discount percentage
`locations[].offerings[].specials[].valid_from`	string\|null	Start date (YYYY-MM-DD)
`locations[].offerings[].specials[].valid_to`	string\|null	End date (YYYY-MM-DD)

Notes

Only active providers are returned. Inactive providers return 404.
Inactive offerings are filtered out automatically.
Only specials that are active and within their validity dates are included.

Error Responses

404 Not Found

{
  "statusCode": 404,
  "message": "Experience provider not found"
}

Provider does not exist or is not active.

Get Experience Provider

On this page