> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Recurrences

> List the schedules attached to an experience

# List Recurrences

Returns every active schedule (recurrence) attached to an experience.
Soft-deleted recurrences are not returned.

A **recurrence** is the rule that produces bookable time slots — a
cadence (frequency + interval + days of week), an end condition, and
one or more **session templates** (start time, capacity, provider).
Without at least one active recurrence, the experience page renders
no time slots.

Requires the `experiences:read` scope. The parent experience must
belong to the API key's organization; cross-org requests return
`404 Not Found`.

## Path Parameters

<ParamField path="experience_id" type="string" required>
  Experience ID (the service catalog document ID).
</ParamField>

## Response

<ResponseField name="data" type="array<object>">
  An array of recurrence objects, each with the shape returned by
  [Get Recurrence](/api-reference/recurrences/get-recurrence).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "X-API-KEY: your_api_key" \
    "https://www.gomry.com/api/v1/experiences/AbCdEfGhIjKlMnOpQrSt/recurrences"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "rec_AbCdEfGh",
        "service_id": "AbCdEfGhIjKlMnOpQrSt",
        "provider_id": "prov_xyz",
        "timezone": "America/New_York",
        "start_date": "2026-09-01",
        "cadence": { "frequency": "weekly", "interval": 1, "days_of_week": [1, 3] },
        "end_condition": { "type": "never" },
        "session_templates": [
          { "start_time_of_day": "09:00", "capacity": 12, "provider_id": "prov_xyz", "days_of_week": null }
        ],
        "status": "active",
        "created_at": "2026-05-25T10:00:00.000Z",
        "updated_at": "2026-05-25T10:00:00.000Z"
      }
    ]
  }
  ```

  ```json 404 theme={null}
  { "error": "Experience not found" }
  ```
</ResponseExample>