# Read an event

Returns one event: when and where it runs, when applications open and close, who
may see it, and the defaults every shift beneath it inherits - the statuses an
application moves through, the forms it collects, the check-in window and the
limits on how many shifts one person may hold.
The `nice` block repeats the same values rendered for display - dates in the
event's timezone, ids resolved to the names behind them - so a listing can be
shown without resolving each id yourself.

Endpoint: GET /api/v2/event/{id}
Version: 2.0.0
Security: default

## Path parameters:

  - `id` (integer, required)
    The ID of the event.

## Header parameters:

  - `Rosterfy-Platform` (string)

## Response 200 fields (application/json):

  - `object` (object)

  - `object.id` (integer)

  - `object.parent_id` (string | null)

  - `object.event_template_id` (string | null)

  - `object.path` (string)

  - `object.account_id` (integer)

  - `object.event_type_id` (integer)

  - `object.journey_id` (string | null)

  - `object.timezone` (string)

  - `object.start_timestamp` (string)

  - `object.end_timestamp` (string)

  - `object.is_ongoing` (integer)

  - `object.apps_open_timestamp` (string)

  - `object.apps_close_timestamp` (string | null)

  - `object.headcount_location_venue_id` (string | null)

  - `object.headcount_functional_area_job_title_id` (string | null)

  - `object.shift_status_default` (integer)

  - `object.max_shift_apps_per_user` (integer)

  - `object.min_shift_apps_per_user` (integer)

  - `object.min_shift_apps_per_shift_type` (string | null)

  - `object.max_shift_apps_per_shift_type` (string | null)

  - `object.gap_between_shifts` (integer)

  - `object.shift_confirmed_status_default` (integer)

  - `object.shift_rejected_status_default` (integer)

  - `object.shift_can_withdraw_default` (integer)

  - `object.shift_can_confirm_default` (integer)

  - `object.shift_can_confirm_limit` (integer)

  - `object.shift_can_withdraw_limit` (integer)

  - `object.shift_checked_in_status_default` (integer)

  - `object.shift_checked_out_status_default` (integer)

  - `object.certificate_id` (string | null)

  - `object.shift_application_form_id_default` (string | null)

  - `object.shift_withdraw_form_id_default` (string | null)

  - `object.shift_checkin_form_id_default` (string | null)

  - `object.shift_attended_form_id_default` (string | null)

  - `object.shift_checkout_form_id_default` (string | null)

  - `object.shift_leader_feedback_form_id_default` (string | null)

  - `object.shift_feedback_form_id_default` (string | null)

  - `object.shift_precheckin_form_id_default` (string | null)

  - `object.shift_default_journey_complete_status` (string | null)

  - `object.shift_default_journey_id` (string | null)

  - `object.allow_user_activities` (integer)

  - `object.user_activity_form_id` (string | null)

  - `object.training_ids` (string | null)

  - `object.banner_image` (string | null)

  - `object.grid_image` (string | null)

  - `object.minimum_dob` (string | null)

  - `object.minimum_age` (string | null)

  - `object.maximum_dob` (string | null)

  - `object.maximum_age` (string | null)

  - `object.visibility_show_groups` (array)

  - `object.visibility_hide_groups` (array)

  - `object.visibility_show_roleoffer` (array)

  - `object.role_offer_address` (integer)

  - `object.checkin_visible_attributes` (array)

  - `object.shift_filter_attributes` (string | null)

  - `object.leader_shift_filter_attributes` (string | null)

  - `object.self_checkin` (integer)

  - `object.self_checkin_open` (integer)

  - `object.self_checkin_close` (integer)

  - `object.self_checkout_close` (integer)

  - `object.checkin_close_default` (integer)

  - `object.shift_precheckin_open_default` (integer)

  - `object.shift_enable_waitlist_default` (integer)

  - `object.geofence_checkin_limit_default` (string | null)

  - `object.max_waitlist` (integer)

  - `object.group_booking_ttl_default` (string | null)

  - `object.max_group_demand_default` (string | null)

  - `object.max_group_size` (string | null)

  - `object.reserved_expiry` (string | null)

  - `object.post_feedback_form` (string | null)

  - `object.post_feedback_publish_at` (string | null)

  - `object.expression_of_interest` (integer)

  - `object.journey_complete_status` (string | null)

  - `object.journey_apply_status` (string | null)

  - `object.expression_of_interest_form` (string | null)

  - `object.cancel_expression_of_interest_form_id` (string | null)

  - `object.eoi_demand` (integer)

  - `object.sort_order` (integer)

  - `object.is_virtual` (integer)

  - `object.status` (string)

  - `object.approval_status` (string)

  - `object.approval_reason` (string | null)

  - `object.promoted` (integer)

  - `object.public` (integer)

  - `object.is_cancelled` (integer)

  - `object.is_archived` (integer)

  - `object.public_shift` (integer)

  - `object.public_shift_default` (integer)

  - `object.token` (string)

  - `object.certificates_awarded` (integer)

  - `object.created_by` (string | null)

  - `object.updated_by` (string | null)

  - `object.deleted_at` (string | null)

  - `object.is_erased` (integer)

  - `object.created_at` (string)

  - `object.updated_at` (string)

  - `object.deleted_by` (string | null)

  - `object.description` (string)

  - `object.name` (string)

  - `object.post_feedback` (string)

  - `object.tags` (string | null)

  - `object.address` (object)

  - `object.address.iso` (string)

  - `object.address.region_code` (string)

  - `object.address.coordinates` (object)

  - `object.address.coordinates.latitude` (string)

  - `object.address.coordinates.longitude` (string)

  - `object.address.street_address_1` (string)

  - `object.address.street_address_2` (string | null)

  - `object.address.street_address_3` (string | null)

  - `object.address.city` (string)

  - `object.address.postcode` (string)

  - `object.address.region` (string)

  - `object.address.country` (string)

  - `object.address.latitude` (string)

  - `object.address.longitude` (string)

  - `nice` (object)

  - `nice.rrn` (string)

  - `nice.address` (string)

  - `nice.address_oneline` (string)

  - `nice.address.country` (string)

  - `nice.address.country:raw` (string)

  - `nice.address.city` (string)

  - `nice.address.region` (string)

  - `nice.address.region:raw` (string)

  - `nice.address.postcode` (string)

  - `nice.address.street_address_1` (string)

  - `nice.address.street_address_2` (string | null)

  - `nice.address.street_address_3` (string | null)

  - `nice.address.latitude` (string)

  - `nice.address.longitude` (string)

  - `nice.allow_user_activities` (string)

  - `nice.approval_status` (string)

  - `nice.approval_status:value` (string)

  - `nice.approval_status:array` (string)

  - `nice.apps_open_timestamp` (string)

  - `nice.apps_open_timestamp__date` (string)

  - `nice.apps_open_timestamp__time` (string)

  - `nice.apps_open_timestamp__offset` (string)

  - `nice.apps_open_timestamp__offset_minutes` (integer)

  - `nice.apps_open_timestamp__dayofweek` (string)

  - `nice.cancel_expression_of_interest_form_id` (string | null)

  - `nice.cancel_expression_of_interest_form_id:value` (string | null)

  - `nice.cancel_expression_of_interest_form_id:array` (string | null)

  - `nice.created_at` (string)

  - `nice.created_at__date` (string)

  - `nice.created_at__time` (string)

  - `nice.created_at__offset` (string)

  - `nice.created_at__offset_minutes` (integer)

  - `nice.created_at__dayofweek` (string)

  - `nice.end_timestamp` (string)

  - `nice.end_timestamp__date` (string)

  - `nice.end_timestamp__time` (string)

  - `nice.end_timestamp__offset` (string)

  - `nice.end_timestamp__offset_minutes` (integer)

  - `nice.end_timestamp__dayofweek` (string)

  - `nice.event_template_id` (string | null)

  - `nice.event_template_id:value` (string | null)

  - `nice.event_template_id:array` (string | null)

  - `nice.event_type_id` (string)

  - `nice.event_type_id:value` (integer)

  - `nice.event_type_id:array` (string)

  - `nice.expression_of_interest` (string)

  - `nice.headcount_location_venue_id` (string | null)

  - `nice.headcount_location_venue_id:value` (string | null)

  - `nice.headcount_location_venue_id:array` (string | null)

  - `nice.is_ongoing` (string)

  - `nice.is_virtual` (string)

  - `nice.name` (string)

  - `nice.promoted` (string)

  - `nice.role_offer_address` (string)

  - `nice.self_checkin` (string)

  - `nice.shift_application_form_id_default` (string | null)

  - `nice.shift_application_form_id_default:value` (string | null)

  - `nice.shift_application_form_id_default:array` (string | null)

  - `nice.shift_attended_form_id_default` (string | null)

  - `nice.shift_attended_form_id_default:value` (string | null)

  - `nice.shift_attended_form_id_default:array` (string | null)

  - `nice.shift_checkin_form_id_default` (string | null)

  - `nice.shift_checkin_form_id_default:value` (string | null)

  - `nice.shift_checkin_form_id_default:array` (string | null)

  - `nice.shift_checkout_form_id_default` (string | null)

  - `nice.shift_checkout_form_id_default:value` (string | null)

  - `nice.shift_checkout_form_id_default:array` (string | null)

  - `nice.shift_feedback_form_id_default` (string | null)

  - `nice.shift_feedback_form_id_default:value` (string | null)

  - `nice.shift_feedback_form_id_default:array` (string | null)

  - `nice.shift_precheckin_form_id_default` (string | null)

  - `nice.shift_precheckin_form_id_default:value` (string | null)

  - `nice.shift_precheckin_form_id_default:array` (string | null)

  - `nice.shift_withdraw_form_id_default` (string | null)

  - `nice.shift_withdraw_form_id_default:value` (string | null)

  - `nice.shift_withdraw_form_id_default:array` (string | null)

  - `nice.start_timestamp` (string)

  - `nice.start_timestamp__date` (string)

  - `nice.start_timestamp__time` (string)

  - `nice.start_timestamp__offset` (string)

  - `nice.start_timestamp__offset_minutes` (integer)

  - `nice.start_timestamp__dayofweek` (string)

  - `nice.status` (string)

  - `nice.status:value` (string)

  - `nice.status:array` (string)

  - `nice.tags` (string | null)

  - `nice.tags:value` (string | null)

  - `nice.tags:array` (string | null)

  - `nice.updated_at` (string)

  - `nice.updated_at__date` (string)

  - `nice.updated_at__time` (string)

  - `nice.updated_at__offset` (string)

  - `nice.updated_at__offset_minutes` (integer)

  - `nice.updated_at__dayofweek` (string)

  - `nice.visibility_hide_groups` (string)

  - `nice.visibility_show_groups` (string)

  - `nice.visibility_show_roleoffer` (string)

  - `nice.full_name` (string)

  - `nice.event_type_name` (string)

  - `nice.grid_list_image` (string | null)

  - `nice.is_eoi_demand_met` (boolean)

  - `nice.has_payrun` (boolean)

  - `nice.min_shifts` (integer)

  - `nice.post_event_feedback_form_completed_at` (string | null)

  - `nice.expression_of_interest_form_completed_at` (string | null)

  - `nice.expression_of_interest_form_cancelled_at` (string | null)

  - `nice.account_name` (string)

  - `relations` (array)

  - `permissions` (object)

  - `permissions.read` (boolean)

  - `permissions.update` (boolean)

  - `permissions.delete` (boolean)

  - `permissions.apply` (boolean)

  - `permissions.cancel` (boolean)

  - `permissions.can_publish` (boolean)

  - `attributes` (object)