---
title: "Get sessions"
method: GET
path: "/sessions/search/{search_id}"
tags: ["Sessions"]
---

# Get sessions

`GET /sessions/search/{search_id}`

## Request

- Base URL: `https://data-reporting-api.prod.feverup.com/v1`
- URL: `https://data-reporting-api.prod.feverup.com/v1/sessions/search/{search_id}`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth/token`
- TypeScript: <https://skmtc.dev/feverup/apis/fever-reporting-api/docs/sessions/search/:search_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get sessions from a search_id.

## Path parameters

- `search_id` string, uuid, required

## Query parameters

- `page` integer

## Headers

- `user-id-to-impersonate` integer: User id from the user that you want to impersonate

## Response `200`

Search was obtained successfully

- SearchSessionSearchDimensionSessionsParams
  - `partition_info` PartitionInfo[]: Partition information
    - `partition_num` integer, required: Partition number
    - `endpoint` string, required: Endpoint to fetch data for partition
    - `size` integer, required: Partition size in bytes
    - `rows` integer, required: Number of rows contained in partition. One row represents a single transaction result (e.g. order, plan etc.).
  - `params` SessionsParams
    - `session_ids` integer[]: List of ids of the sessions to filter by.
    - `plan_ids` integer[]: List of ids of the plans to filter by.
    - `updated_date_utc_from` string: UTC start date for the warehouse last-updated filter (inclusive). Filters rows whose underlying warehouse record changed at or after this instant. If hour and minute are not specified, 00:00 is added by default
    - `updated_date_utc_to` string: UTC end date for the warehouse last-updated filter (exclusive). Filters rows whose underlying warehouse record changed strictly before this instant. If hour and minute are not specified, 00:00 is added by default
  - `data` SessionSearchDimension[], required: Data rows
    - `id` integer, required: Session ID
    - `name` string: Session name
    - `available_tickets` integer: Session available tickets. This field is always null if the session is a wait list.
    - `capacity` integer: Session capacity. This field is always null if the session is a wait list.
    - `end_date_utc` string: Session end date
    - `first_purchasable_date_utc` string: Session first purchasable date
    - `is_addon` boolean: Is the session an addon
    - `is_shop_product` boolean: Is the session a shop product
    - `is_wait_list` boolean: Is the session a wait list. Deprecated, since now the waitlist flag is configured at plan level
    - `start_date_utc` string: Session start date
    - `venue` Venue
      - `city` string: Venue city
      - `country` string: Venue country
      - `name` string: Venue name
      - `timezone` string: Venue timezone
    - `timeslot_capacity` integer: Total timeslot capacity. Null for waitlist plans or anytime plans.
    - `plan_id` integer: Plan ID
    - `tags` string[]: Session tags
    - `ticket_price` number: Session ticket price
    - `ticket_price_tax_base` number: Session ticket price tax base
    - `surcharge_per_ticket` number: Session surcharge per ticket
    - `surcharge_per_ticket_tax_base` number: Session surcharge per ticket tax base
    - `session_type_id` integer, required: Fever session-type identifier. Join key for /reports/entitlements.
    - `product_type` string: Session product type. Null when the session has no associated session type.
    - `customer_profile` string: Target customer profile of the session. Null when the session has no associated session type.
    - `group_name` string: Name of the session type group. Null when the session type has no associated group.
    - `updated_date_utc` string: UTC timestamp of the last modification of the session record in the warehouse. This is the value the `updated_date_utc_from` / `updated_date_utc_to` request filters match against, so a search by that window and the returned value are always consistent. It tracks changes to the session itself (inventory, dates, pricing, configuration...), so an inventory movement always advances it — but so does any other change to the session, and it does not track the related entities the response denormalises (venue, hub, session type group).
    - `hub` SessionHub
      - `id` integer: Unique identifier of the hub. Source: session.venue_id → PREMILLER_LAKE_CORE_ASSETS_HUB_PLACES.PLACE_ID → ASSETS_HUB_ID → PREMILLER_LAKE_CORE_ASSETS_HUB.ID.
      - `name` string: Display name of the hub. Source: PREMILLER_LAKE_CORE_ASSETS_HUB.NAME.
    - `tag_groups` SessionTagGroup[]: FeverZone tags of the session's session type, one group per tag type, ordered by the tag type's FeverZone sort order; tags without a tag type come last in a group with a null `type`. Not the same as `tags`, which holds the legacy partner session type tags. Shared by every session of the session type. Null when the session type has no tags. A tag change does not advance `updated_date_utc`.
      - `type` SessionTagType
        - `id` integer: Tag type ID
        - `name` string: Tag type name
      - `tags` SessionTag[]: Tags of this type, ordered by name.
        - `id` integer: Tag ID
        - `name` string: Tag name
        - `color` string: Badge color of the tag
        - `icon` string: Badge icon of the tag

## Other responses

- `202`: Request is still running asynchronously.
- `400`: Bad Request
- `404`: Not Found
- `408`: Request Timeout
- `410`: Search expired
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/feverup/apis/fever-reporting-api.md) - [All operations](https://skmtc.dev/feverup/apis/fever-reporting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/feverup/apis/fever-reporting-api/revisions/a2e1afe5c12d?raw)