---
title: "List flow sessions"
method: GET
path: "/flow_sessions"
tags: ["flow_sessions"]
---

# List flow sessions

`GET /flow_sessions`

## Query parameters

- `subscriber_id` string
- `subscription_id` string
- `status` 'saved' | 'deflected' | 'canceled' | 'incomplete'
- `started_at` string
- `completed_at` string
- `updated_at` string
- `cursor` string
- `limit` integer

## Response `200`

OK

- object
  - `data` FlowSession[], required
    - `id` string, required
    - `status` 'canceled' | 'saved' | 'deflected' | 'incomplete' | 'rerouted', required
    - `created_at` string, date-time, required
    - `started_at` string, date-time, nullable, required
    - `updated_at` string, date-time, required
    - `completed_at` string, date-time, nullable, required
    - `flow` Flow, required
      - `id` string, required
      - `name` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `subscriber` Subscriber, required
      - `id` string, required
      - `platform_id` string, required
      - `name` string, required
      - `email` string, required
      - `status` 'active' | 'canceled' | 'converted' | 'deflected' | 'inactive' | 'reactivated' | 'recovered' | 'saved', required
      - `properties` SubscriberPropertyValue[], required
        - `property` SubscriberProperty, required
          - `id` string, required
          - `key` string, required
          - `name` string, required
          - `entity` 'subscriber', required
          - `type` 'text' | 'number' | 'boolean' | 'date', required
          - `format` 'number' | 'currency', nullable, required
        - `value` union, required
          - string
          - string, date
          - number
          - boolean
        - `formatted_value` string, required
      - `data` object, required — Additional data about the subscriber from the connected subscription platform
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `subscription` Subscription, required
      - `id` string, required
      - `platform_id` string, required
      - `subscriber_id` string, required
      - `mrr` string, required
      - `status` 'active' | 'canceled' | 'future' | 'paused' | 'trialing', required
      - `properties` SubscriptionPropertyValue[], required
        - `property` SubscriptionProperty, required
          - `id` string, required
          - `key` string, required
          - `name` string, required
          - `entity` 'subscription', required
          - `type` 'text' | 'number' | 'boolean' | 'date', required
          - `format` 'number' | 'currency', nullable, required
        - `value` union, required
          - string
          - string, date
          - number
          - boolean
        - `formatted_value` string, required
      - `data` object, required — Additional data about the subscription from the connected subscription platform
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `offers_presented` Offer[], required
      - `id` string, required
      - `type` 'change_frequency' | 'change_plan' | 'coupon' | 'custom' | 'downgrade' | 'dunning' | 'free_gift' | 'modify_subscription' | 'pause_subscription' | 'product_swap' | 'purchase' | 'reactivate' | 'reschedule_order' | 'trial_extension' | 'upgrade', required
      - `goal` 'retention' | 'conversion' | 'reactivation', required
      - `context` 'cancellation_flow' | 'conversion_campaign' | 'landing_page', required
      - `name` string, required
      - `details` union, required
        - ChangeFrequencyOfferDetails
          - `type` 'change_frequency', required
          - `interval` 'day' | 'week' | 'month' | 'year', required
          - `interval_count` number, required
          - `metadata` object, required
          - `options` object[], required — All available change-frequency options for this offer
            - `interval` 'day' | 'week' | 'month' | 'year', required
            - `interval_count` number, required
            - `metadata` object, required
        - ChangePlanOfferDetails
          - `type` 'change_plan', required
          - `platform_plan_id` string, required
          - `prorate` boolean, required
          - `platform_coupon_id` string, nullable, required
        - CouponOfferDetails
          - `type` 'coupon', required
          - `coupon_type` 'percentage' | 'fixed', required
          - `amount_off` string, required
          - `duration` 'once' | 'forever' | 'repeating', required
          - `months` number, nullable, required
          - `apply_to` 'subscription' | 'subscriber', required
          - `platform_coupon_id` string, nullable, required
        - CustomOfferDetails
          - `type` 'custom', required
        - DowngradeOfferDetails
          - `type` 'downgrade', required
        - DunningOfferDetails
          - `type` 'dunning', required
        - FreeGiftOfferDetails
          - `type` 'free_gift', required
          - `platform_variant_id` string, nullable, required — Platform-specific identifier of the product variant offered as the free gift
        - ModifySubscriptionOfferDetails
          - `type` 'modify_subscription', required
          - `modifications` object[], required — Modifications applied to the subscription when the offer is accepted
            - `action` 'add_plan' | 'remove_plan' | 'add_add_on' | 'remove_add_on', required
            - `platform_plan_id` string, nullable, required — Platform-specific identifier of the plan or add-on affected by this modification
        - PauseSubscriptionOfferDetails
          - `type` 'pause_subscription', required
          - `interval` 'day' | 'week' | 'month' | 'indefinitely' | 'billing_cycle', required
          - `interval_count` number, required
          - `pause_at` 'immediately' | 'period_end', required
          - `metadata` object, required
          - `options` object[], required — All available pause options for this offer
            - `interval` 'day' | 'week' | 'month' | 'indefinitely' | 'billing_cycle', required
            - `interval_count` number, required
            - `metadata` object, required
        - ProductSwapOfferDetails
          - `type` 'product_swap', required
        - PurchaseOfferDetails
          - `type` 'purchase', required
        - ReactivateOfferDetails
          - `type` 'reactivate', required
        - RescheduleOrderOfferDetails
          - `type` 'reschedule_order', required
        - TrialExtensionOfferDetails
          - `type` 'trial_extension', required
          - `days` number, required
        - UpgradeOfferDetails
          - `type` 'upgrade', required
      - `metadata` object, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `offer_groups_presented` OfferGroup[], required
      - `id` string, required
      - `name` string, required
      - `offers` Offer[], required
        - `id` string, required
        - `type` 'change_frequency' | 'change_plan' | 'coupon' | 'custom' | 'downgrade' | 'dunning' | 'free_gift' | 'modify_subscription' | 'pause_subscription' | 'product_swap' | 'purchase' | 'reactivate' | 'reschedule_order' | 'trial_extension' | 'upgrade', required
        - `goal` 'retention' | 'conversion' | 'reactivation', required
        - `context` 'cancellation_flow' | 'conversion_campaign' | 'landing_page', required
        - `name` string, required
        - `details` union, required
          - ChangeFrequencyOfferDetails
            - `type` 'change_frequency', required
            - `interval` 'day' | 'week' | 'month' | 'year', required
            - `interval_count` number, required
            - `metadata` object, required
            - `options` object[], required — All available change-frequency options for this offer
              - …
          - ChangePlanOfferDetails
            - `type` 'change_plan', required
            - `platform_plan_id` string, required
            - `prorate` boolean, required
            - `platform_coupon_id` string, nullable, required
          - CouponOfferDetails
            - `type` 'coupon', required
            - `coupon_type` 'percentage' | 'fixed', required
            - `amount_off` string, required
            - `duration` 'once' | 'forever' | 'repeating', required
            - `months` number, nullable, required
            - `apply_to` 'subscription' | 'subscriber', required
            - `platform_coupon_id` string, nullable, required
          - CustomOfferDetails
            - `type` 'custom', required
          - DowngradeOfferDetails
            - `type` 'downgrade', required
          - DunningOfferDetails
            - `type` 'dunning', required
          - FreeGiftOfferDetails
            - `type` 'free_gift', required
            - `platform_variant_id` string, nullable, required — Platform-specific identifier of the product variant offered as the free gift
          - ModifySubscriptionOfferDetails
            - `type` 'modify_subscription', required
            - `modifications` object[], required — Modifications applied to the subscription when the offer is accepted
              - …
          - PauseSubscriptionOfferDetails
            - `type` 'pause_subscription', required
            - `interval` 'day' | 'week' | 'month' | 'indefinitely' | 'billing_cycle', required
            - `interval_count` number, required
            - `pause_at` 'immediately' | 'period_end', required
            - `metadata` object, required
            - `options` object[], required — All available pause options for this offer
              - …
          - ProductSwapOfferDetails
            - `type` 'product_swap', required
          - PurchaseOfferDetails
            - `type` 'purchase', required
          - ReactivateOfferDetails
            - `type` 'reactivate', required
          - RescheduleOrderOfferDetails
            - `type` 'reschedule_order', required
          - TrialExtensionOfferDetails
            - `type` 'trial_extension', required
            - `days` number, required
          - UpgradeOfferDetails
            - `type` 'upgrade', required
        - `metadata` object, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `offer_accepted` AcceptedOffer, required
      - `id` string, required
      - `type` 'change_frequency' | 'change_plan' | 'coupon' | 'custom' | 'downgrade' | 'dunning' | 'free_gift' | 'modify_subscription' | 'pause_subscription' | 'product_swap' | 'purchase' | 'reactivate' | 'reschedule_order' | 'trial_extension' | 'upgrade', required
      - `goal` 'retention' | 'conversion' | 'reactivation', required
      - `context` 'cancellation_flow' | 'conversion_campaign' | 'landing_page', required
      - `name` string, required
      - `details` union, required
        - ChangeFrequencyAcceptedOfferDetails
          - `type` 'change_frequency', required
          - `interval` 'day' | 'week' | 'month' | 'year', required
          - `interval_count` number, required
          - `metadata` object, required
        - ChangePlanOfferDetails
          - `type` 'change_plan', required
          - `platform_plan_id` string, required
          - `prorate` boolean, required
          - `platform_coupon_id` string, nullable, required
        - CouponOfferDetails
          - `type` 'coupon', required
          - `coupon_type` 'percentage' | 'fixed', required
          - `amount_off` string, required
          - `duration` 'once' | 'forever' | 'repeating', required
          - `months` number, nullable, required
          - `apply_to` 'subscription' | 'subscriber', required
          - `platform_coupon_id` string, nullable, required
        - CustomOfferDetails
          - `type` 'custom', required
        - DowngradeOfferDetails
          - `type` 'downgrade', required
        - DunningOfferDetails
          - `type` 'dunning', required
        - FreeGiftOfferDetails
          - `type` 'free_gift', required
          - `platform_variant_id` string, nullable, required — Platform-specific identifier of the product variant offered as the free gift
        - ModifySubscriptionOfferDetails
          - `type` 'modify_subscription', required
          - `modifications` object[], required — Modifications applied to the subscription when the offer is accepted
            - `action` 'add_plan' | 'remove_plan' | 'add_add_on' | 'remove_add_on', required
            - `platform_plan_id` string, nullable, required — Platform-specific identifier of the plan or add-on affected by this modification
        - PauseSubscriptionAcceptedOfferDetails
          - `type` 'pause_subscription', required
          - `interval` 'day' | 'week' | 'month' | 'indefinitely' | 'billing_cycle', required
          - `interval_count` number, required
          - `pause_at` 'immediately' | 'period_end', required
          - `metadata` object, required
        - ProductSwapAcceptedOfferDetails
          - `type` 'product_swap', required
          - `platform_variant_id` string, nullable, required — Platform-specific identifier of the product variant the subscriber swapped to
        - PurchaseOfferDetails
          - `type` 'purchase', required
        - ReactivateOfferDetails
          - `type` 'reactivate', required
        - RescheduleOrderAcceptedOfferDetails
          - `type` 'reschedule_order', required
          - `action` 'reschedule' | 'skip', required — Action taken on the upcoming order
          - `reschedule_to` string, date-time — Timestamp the order was rescheduled to, present when `action` is `reschedule`
        - TrialExtensionOfferDetails
          - `type` 'trial_extension', required
          - `days` number, required
        - UpgradeOfferDetails
          - `type` 'upgrade', required
      - `metadata` object, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `answers` Answer[], required
      - `question` Question, required
        - `id` string, required
        - `type` 'multiple_choice' | 'text', required
        - `text` string, required
        - `primary` boolean, required
      - `value` union, required
        - MultipleChoiceValue
          - `id` string, required
          - `text` string, required
        - MultipleChoiceOtherValue
          - `text` string, required
        - string
      - `sentiment` 'positive' | 'negative' | 'neutral', nullable, required
    - `steps` FlowSessionStep[], required
      - `step` FlowStep, required
        - `id` string, required
        - `type` 'acknowledgements' | 'confirmation' | 'deflection' | 'instant_cancel' | 'offer' | 'question', required
        - `title` string, required
      - `started_at` string, date-time, required
      - `completed_at` string, date-time, nullable, required
    - `cancel_reason` CancelReason, required
      - `text` string, required
      - `reason_code` string, nullable, required
    - `deflected_by` FlowSessionDeflectedBy, required
      - `type` 'automatic' | 'deflection', required
      - `details` FlowSessionDeflectedByDetails, required
        - `deflection` Deflection, required
          - `id` string, required
          - `name` string, required
          - `actions` FlowAction[], required
            - `id` string, required
            - `code` string, nullable, required
            - `type` 'url', required
            - `details` FlowActionUrlDetails, required
              - …
        - `action` FlowAction, required
          - `id` string, required
          - `code` string, nullable, required
          - `type` 'url', required
          - `details` FlowActionUrlDetails, required
            - `url` string, url, required
    - `rerouted_from_flow_session_id` string, nullable, required
    - `client` object, required
      - `user_agent` string, nullable, required
      - `url` string, nullable, required — URL the flow session was initiated from
  - `next_cursor` string, nullable

## Other responses

- `401` — Error

---

[API](https://skmtc.dev/prosperstack/apis/prosperstack-api-reference.md) · [All operations](https://skmtc.dev/prosperstack/apis/prosperstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prosperstack/prosperstack-api-reference/revisions/407ea9202622/schema)