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

const response = await fetch(
  "https://www.gomry.com/api/v1/experiences?page=1&page_size=20",
  { headers: { "X-API-KEY": "your_api_key" } }
);
const { data, pagination } = await response.json();

{
  "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
  }
}

GET

experiences

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

const response = await fetch(
  "https://www.gomry.com/api/v1/experiences?page=1&page_size=20",
  { headers: { "X-API-KEY": "your_api_key" } }
);
const { data, pagination } = await response.json();

{
  "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

integer

default:"1"

Page number (starts at 1).

integer

default:"50"

Number of experiences per page. Maximum: 200.

string

default:"active"

Comma-separated list of statuses to include.Allowed values: active, inactive.Example: ?status=active,inactive

Response

array

Show Experience object

string

Unique experience identifier

string | null

Experience name

string | null

Description

string | null

active or inactive

string

open or closed — whether new bookings are accepted

number | null

Length of one session in minutes

number | null

Maximum attendees per session

number | null

Upper bound on seats per single booking

string | null

none, email, or email_and_phone

string[]

Array of photo URLs

string | null

First photo, if any

object | null

Show child attributes

string

in_person, virtual, or hybrid

string | null

Venue name

string | null

Street address

string | null

For virtual / hybrid

object | null

Show child attributes

string

per_session, package, subscription, or dynamic

string

ISO 4217 currency code

number | null

Price (for per_session / package / subscription)

number | null

For dynamic pricing

number | null

For dynamic pricing

number | null

For dynamic pricing

number | null

For package pricing

string | null

week or month (for subscription)

object | null

Show child attributes

object

Show child attributes

number

Cut-off in hours before session start

number

How far in advance bookings are allowed

object

Show child attributes

number

object | null

Optional { currency, amount }

number

Lifetime confirmed bookings

boolean

When true, the organizer absorbs Gomry’s service fee

boolean

Whether the experience is in tier mode

string[]

SpaceMember IDs of providers running this experience

string | null

ISO 8601 creation timestamp

string | null

ISO 8601 last-updated timestamp

object

Show child attributes

integer

Total number of matching experiences

integer

Current page number

integer

Items per page

integer

Total number of pages

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

const response = await fetch(
  "https://www.gomry.com/api/v1/experiences?page=1&page_size=20",
  { headers: { "X-API-KEY": "your_api_key" } }
);
const { data, pagination } = await response.json();

{
  "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
  }
}

Update Event Get Experience

Events

Experiences

Recurrences

Attendees

Contacts

Ticket Classes

Forms

Applications

Custom Fields

Lists

Payments

List Experiences

List Experiences

Query Parameters

Response

​List Experiences

​Query Parameters

​Response

List Experiences

Query Parameters

Response