List programs

Returns a paginated list of programs. Registration opportunities (sessions) are excluded by default for performance - use ?include=programs to include them.

Headers

X-Api-Version
Type: string

Optional API version for this request. When omitted, the server uses the default version. This documentation describes version 2026-02-01.

Responses

application/json
application/json

get/parent_programs

curl https://api.getcommunal.com/api/parent_programs \
  --header 'X-Api-Version: 2026-02-01' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "data": [
    {
      "id": 5,
      "title": "Summer Sports Programs",
      "description": "A collection of exciting summer sports programs for all ages.",
      "event_start_date": "2025-06-01T12:00:00.000000Z",
      "event_end_date": "2025-08-31T15:00:00.000000Z",
      "registration_start_date": "2025-01-01T12:00:00.000000Z",
      "registration_end_date": "2025-02-03T12:00:00.000000Z",
      "ongoing": false,
      "status": "active",
      "dates": "June 1 - August 31, 2025",
      "registration_dates": "May 1 - May 31, 2025",
      "is_event": false,
      "draft": false,
      "is_hidden": false,
      "profile_image": "https://example.com/images/summer-sports.jpg",
      "limit": 120,
      "total_spots": 120,
      "available_spots": 34,
      "total_signups": 86,
      "reserved_spots": 60,
      "reserved_spots_signups": 44,
      "reserved_spots_remaining": 16,
      "uncapped_spots": 60,
      "uncapped_spots_signups": 42,
      "uncapped_spots_remaining": 18,
      "demographic": "Youth (Ages 8-12)",
      "instructor": "Jane Coach",
      "location_name": "Main Gymnasium",
      "location_address": "123 Main St, Springfield, IL",
      "location_latitude": 43.6532,
      "location_longitude": -79.3832,
      "is_online": false,
      "readable_event_start_date": "Thu, Jun 1, 2025 7:00 PM",
      "readable_event_end_date": "Sat, Aug 31, 2025 5:00 PM",
      "event_start_time": "19:00",
      "event_end_time": "17:00",
      "registration_start_time": "09:00",
      "registration_end_time": "23:59",
      "display_only": false,
      "unsplash_author_name": "Alex Photographer",
      "unsplash_author_link": "https://unsplash.com/@alex",
      "multiple_signups": false,
      "prompt_for_number_of_guests": true,
      "prompt_for_registrant": true,
      "waitlist_enabled": true,
      "force_participant_selection": false,
      "show_participant_list": true,
      "hide_participant_details": false,
      "pay_by_cash": false,
      "registration_fee": 2500,
      "cap_registration_fee": false,
      "ignores_tax_rates": false,
      "collection_additional_information": true,
      "require_emergency_contact_information": true,
      "block_facility_calendars": false,
      "auto_archive": true,
      "auto_archive_days": 0,
      "participant_must_hold_membership": false,
      "form_id": 42,
      "allow_file_uploads": true,
      "file_uploads_required": false,
      "file_uploads_max": 3,
      "volunteer_opportunities_ids": [
        3,
        7,
        11
      ],
      "facility_ids": [
        2,
        5
      ],
      "sort_order": 0,
      "manual_order_enabled": false,
      "gl_code": "4000-100",
      "created_at": "2025-01-15T10:30:00.000000Z",
      "updated_at": "2025-01-20T14:45:00.000000Z",
      "deleted_at": "2025-01-25T12:00:00.000000Z",
      "archived_at": "2025-01-30T18:00:00.000000Z",
      "facilities": "string",
      "registration_opportunities": "string",
      "member_pricing_savings": {
        "name": "Gold Membership",
        "guest_price": 4500,
        "price": 3500,
        "savings": 1000
      },
      "volunteer_opportunities": "string",
      "waiver_assignments": "string",
      "tags": "string"
    }
  ],
  "current_page": 1,
  "from": null,
  "last_page": 1,
  "per_page": 1,
  "to": null,
  "total": 0
}

Paginated set of Program