Get a registration opportunity

Path Parameters
  • program
    Type: string
    required
Query Parameters
  • include
    Type: string

    Include related resources (comma-separated). Options: metadata, prices, prices.membership, prices.plan, prices.schedule_config, signups, parentProgram, waitlistSignups, attendanceSheets, occurrences, recurrenceRule.

  • append
    Type: string

    Append computed attributes (comma-separated). Options: signup_count.

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-03-25.

Responses
  • application/json
  • application/json
Request Example for get/programs/{program}
curl 'https://api.getcommunal.com/api/programs/{program}?include=prices%2Csignups&append=signup_count' \
  --header 'X-Api-Version: 2026-03-25' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": 42,
  "name": "Youth Basketball Camp",
  "description": "A fun week-long basketball camp for ages 8-12.",
  "parent_program_id": 5,
  "class_limit": 25,
  "event_start_date": "2025-07-01T09:00:00.000000Z",
  "event_end_date": "2025-07-05T16:00:00.000000Z",
  "registration_start_date": "2025-05-01T00:00:00.000000Z",
  "registration_end_date": "2025-06-25T23:59:59.000000Z",
  "registration_open_until_event_start": true,
  "readable_event_start_date": "July 1, 2025",
  "readable_event_end_date": "July 5, 2025",
  "readable_registration_start_date": "May 1, 2025",
  "readable_registration_end_date": "June 25, 2025",
  "event_start_time": "09:00:00",
  "event_end_time": "16:00:00",
  "readable_event_start_time": "9:00 AM",
  "readable_event_end_time": "4:00 PM",
  "status": "active",
  "ongoing": false,
  "archived_at": "2025-01-30T18:00:00.000000Z",
  "deleted_at": "2025-01-25T12:00:00.000000Z",
  "waitlist_enabled": true,
  "exclude_from_reminder_emails": false,
  "is_priority_waitlist_locked": false,
  "multiple_signups": false,
  "display_to_all_users": true,
  "hide_from_non_buyers": false,
  "dob_validation": true,
  "min_date_of_birth": "2017-12-31",
  "max_date_of_birth": "2013-01-01",
  "program_prices": [
    {
      "price": 7500,
      "label": "Member"
    },
    {
      "price": 10000,
      "label": "Non-Member"
    }
  ],
  "free": false,
  "ignore_gst": false,
  "product_id": "prod_abc123",
  "registration_start_time": "00:00:00",
  "registration_end_time": "23:59:59",
  "is_event": false,
  "prompt_for_registrant": false,
  "prompt_for_number_of_guests": false,
  "force_additional_member_info": false,
  "allow_file_uploads": false,
  "file_uploads_required": false,
  "file_uploads_max": 5,
  "pay_by_cash": true,
  "collect_additional_information": false,
  "form_id": 15,
  "created_at": "2025-01-15T10:30:00.000000Z",
  "updated_at": "2025-01-20T14:45:00.000000Z",
  "member_savings": 1000,
  "price_for_user": 7500,
  "num_signups_remaining_for_user": 2,
  "lowest_price_excluded": 5000,
  "highest_price": 15000,
  "signup_count": 18,
  "is_full": false,
  "spots_remaining": 7,
  "user_signup_count": 1,
  "volunteer_price": 5000,
  "volunteer_price_is_free": true,
  "price_id_for_user": "price_abc123",
  "required_membership_id_for_user": "prod_abc123",
  "price_recurs_for_user": true,
  "price_interval_for_user": "month",
  "price_interval_count_for_user": 1,
  "can_user_purchase": true,
  "required_membership_names": [
    "Base Membership",
    "Premium Membership"
  ],
  "signups": "string",
  "parent_program": "string",
  "prices": "string",
  "metadata": "string",
  "waivers": "string",
  "waitlist_signups": "string",
  "attendance_sheets": "string",
  "occurrences": "string",
  "recurrence_rule": "string"
}