Skip to main content
GET
/
experiences
curl -H "X-API-KEY: your_api_key" \
  "https://www.gomry.com/api/v1/experiences?page=1&page_size=20"

{
  "data": [
    {
      "id": "AbCdEfGhIjKlMnOpQrSt",
      "name": "Sunset Yoga",
      "description": "60-minute beach yoga session at sunset.",
      "status": "active",
      "registration_status": "open",
      "duration_minutes": 60,
      "default_capacity": 20,
      "max_booking_quantity": 5,
      "required_contact_method": "email",
      "photos": ["https://storage.googleapis.com/..."],
      "cover_image": "https://storage.googleapis.com/...",
      "location": {
        "type": "in_person",
        "venue": "Ocean Beach",
        "address": "Ocean Beach",
        "city": "San Francisco",
        "state": "CA",
        "country": "US",
        "instructions": null,
        "video_link": null
      },
      "pricing": {
        "model": "per_session",
        "currency": "usd",
        "amount": 25,
        "base_price": null,
        "floor_price": null,
        "ceiling_price": null,
        "sessions_included": null,
        "interval": null
      },
      "scheduling_rules": {
        "booking_window": { "min_hours_before": 1, "max_days_ahead": 60 },
        "cancellation_policy": { "refundable_until_hours_before": 24, "late_cancel_fee": null }
      },
      "bookings_count": 87,
      "remove_service_fees": false,
      "use_ticket_classes": false,
      "providers": [],
      "created_at": "2025-03-01T10:00:00.000Z",
      "updated_at": "2025-06-20T15:30:00.000Z"
    }
  ],
  "pagination": {
    "total": 4,
    "page": 1,
    "page_size": 20,
    "total_pages": 1
  }
}

​
List Experiences

Returns a paginated list of experiences (recurring offerings — yoga classes, workshops, coaching slots) belonging to your organization. Experiences are distinct from Events. An Event is a one-shot ticketed gathering with a fixed start/end. An Experience is a recurring catalog entry that generates bookable sessions on a schedule.

​
Query Parameters

​
page
integer
default:"1"
Page number (starts at 1).
​
page_size
integer
default:"50"
Number of experiences per page. Maximum: 200.
​
status
string
default:"active"
Comma-separated list of statuses to include.Allowed values: active, inactive.Example: ?status=active,inactive

​
Response

​
data
array
​
pagination
object
curl -H "X-API-KEY: your_api_key" \
  "https://www.gomry.com/api/v1/experiences?page=1&page_size=20"

{
  "data": [
    {
      "id": "AbCdEfGhIjKlMnOpQrSt",
      "name": "Sunset Yoga",
      "description": "60-minute beach yoga session at sunset.",
      "status": "active",
      "registration_status": "open",
      "duration_minutes": 60,
      "default_capacity": 20,
      "max_booking_quantity": 5,
      "required_contact_method": "email",
      "photos": ["https://storage.googleapis.com/..."],
      "cover_image": "https://storage.googleapis.com/...",
      "location": {
        "type": "in_person",
        "venue": "Ocean Beach",
        "address": "Ocean Beach",
        "city": "San Francisco",
        "state": "CA",
        "country": "US",
        "instructions": null,
        "video_link": null
      },
      "pricing": {
        "model": "per_session",
        "currency": "usd",
        "amount": 25,
        "base_price": null,
        "floor_price": null,
        "ceiling_price": null,
        "sessions_included": null,
        "interval": null
      },
      "scheduling_rules": {
        "booking_window": { "min_hours_before": 1, "max_days_ahead": 60 },
        "cancellation_policy": { "refundable_until_hours_before": 24, "late_cancel_fee": null }
      },
      "bookings_count": 87,
      "remove_service_fees": false,
      "use_ticket_classes": false,
      "providers": [],
      "created_at": "2025-03-01T10:00:00.000Z",
      "updated_at": "2025-06-20T15:30:00.000Z"
    }
  ],
  "pagination": {
    "total": 4,
    "page": 1,
    "page_size": 20,
    "total_pages": 1
  }
}