---
title: "List Scheduled Screenings"
method: GET
path: "/scheduled_screenings"
tags: ["Screening"]
---

# List Scheduled Screenings

`GET /scheduled_screenings`

List the scheduled screenings to which the currently authenticated user has read access.

## Query parameters

- `filters` string, nullable
- `sort_field` string
- `sort_direction` 'asc' | 'desc'
- `offset` integer
- `count` integer
- `fields` string

## Response `200`

Successful Response

- OffsetPageResultScheduledScreeningRead
  - `pagination` OffsetPagination, required
    - `offset` integer — Offset in the collection to begin the page.
    - `count` integer — Number of items to retrieve. 0 returns all items.
  - `items` ScheduledScreeningRead[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `group_id` string, uuid, nullable
    - `last_screening_id` string, uuid, nullable
    - `next_run_at` string, date-time, nullable
    - `last_run_at` string, date-time, nullable
    - `cadence_hr` integer, required
    - `start_time` string, time, required
    - `enabled` boolean, required
    - `config` object, required
    - `last_screening` ScreeningPreview
      - `id` string, uuid, required
      - `group_id` string, uuid, nullable
      - `owner` UserProfilePreview
        - `id` string, uuid, required
        - `username` string, nullable
        - `full_name` string, nullable
        - `avatar_url` string, nullable
        - `email` string, nullable
      - `status` 'CREATED' | 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILURE' | 'CANCELED', required
      - `started_at` string, date-time, nullable
      - `created_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `threshold_radius_km` number, required
      - `threshold_radius_manned_km` number, nullable
      - `threshold_radius_active_km` number, nullable
      - `threshold_radius_debris_km` number, nullable
      - `default_secondary_hbr_m` number, required
      - `auto_archive` boolean, required
      - `include_primary_vs_primary` boolean, required
      - `title` string, nullable
      - `notes` string, nullable
      - `screening_type` 'ON_ORBIT' | 'LAUNCH', required
      - `hard_body_shape` 'SQUARE' | 'CIRCLE', required
      - `strict_coverage` boolean, required
      - `publish_cdms` boolean, required
      - `screen_count_expected` integer, nullable
      - `screen_count_current` integer, nullable
      - `launch_window_start` string, date-time, nullable
      - `launch_window_end` string, date-time, nullable
      - `launch_window_cadence_s` integer, nullable
      - `archived` boolean, required
      - `percent_complete` number, required
      - `primary_sources_count` integer
      - `secondary_sources_count` integer
      - `primaries_count` integer, nullable
      - `secondaries_count` integer, nullable
      - `lowest_miss_distance_km` number, nullable
      - `highest_pc` number, nullable
      - `next_tca` string, date-time, nullable
      - `propagation_start_time` string, date-time, nullable
      - `propagation_duration_s` number, nullable
      - `propagation_timestep_s` number, nullable
      - `secondary_any_coverage_end` string, date-time, nullable
      - `secondary_any_coverage_start` string, date-time, nullable
      - `secondary_full_coverage_end` string, date-time, nullable
      - `secondary_full_coverage_start` string, date-time, nullable
      - `failure_message` string, nullable
      - `conjunctions_count` integer, required
      - `high_risk_conjunctions_count` integer, required
      - `high_risk_pc` number, required
      - `high_risk_md_km` number, required
      - `low_risk_pc` number, required
      - `low_risk_md_km` number, required
      - `ssc_sustainability_threshold_conjunction_count` integer, required
      - `ssc_maneuver_planning_threshold_conjunction_count` integer, required
      - `conjunctions_preview` ConjunctionMinimal[]
        - `tca` string, date-time, required
        - `miss_distance_km` number, required
        - `launch_time` string, date-time, nullable
        - `collision_probability` number, nullable
        - `primary` EphemerisMetadataWithRSOMinimalRead
          - `id` string, uuid, nullable
          - `rso_id` string, uuid, nullable
          - `filename` string, nullable
          - `data_format` 'hdf5' | 'original' | 'gem'
          - `custom_storage_path` string, nullable
          - `altitude_km` number, nullable
          - `repository_public` boolean
          - `event_public` boolean
          - `shared_event_keys` EphemerisViewer[], nullable
            - `ephemeris_id` string, uuid, nullable
            - `event_key_number` integer, nullable
          - `rso` RSORead
            - `id` string, uuid, required
            - `norad_id` integer, nullable
            - `international_designator` string, nullable
            - `object_type` string, nullable
            - `object_type_category` string, nullable
            - `object_name` string, nullable
          - `user_id` string, uuid, nullable
          - `group_id` string, uuid, nullable
          - `covariance_corrected` boolean, nullable
          - `source_ephemeris_id` string, uuid, nullable
        - `secondary` EphemerisMetadataWithRSOMinimalRead
          - `id` string, uuid, nullable
          - `rso_id` string, uuid, nullable
          - `filename` string, nullable
          - `data_format` 'hdf5' | 'original' | 'gem'
          - `custom_storage_path` string, nullable
          - `altitude_km` number, nullable
          - `repository_public` boolean
          - `event_public` boolean
          - `shared_event_keys` EphemerisViewer[], nullable
            - `ephemeris_id` string, uuid, nullable
            - `event_key_number` integer, nullable
          - `rso` RSORead
            - `id` string, uuid, required
            - `norad_id` integer, nullable
            - `international_designator` string, nullable
            - `object_type` string, nullable
            - `object_type_category` string, nullable
            - `object_name` string, nullable
          - `user_id` string, uuid, nullable
          - `group_id` string, uuid, nullable
          - `covariance_corrected` boolean, nullable
          - `source_ephemeris_id` string, uuid, nullable
      - `primary_sources_preview` ScreenableRead[]
        - `id` string, uuid, required
        - `ephemeris_id` string, uuid, nullable
        - `catalog_id` string, uuid, nullable
        - `propagation_id` string, uuid, nullable
        - `ephemeris` EphemerisMetadataWithRSO
          - `id` string, uuid, nullable
          - `rso_id` string, uuid, nullable
          - `filename` string, nullable
          - `data_format` 'hdf5' | 'original' | 'gem'
          - `custom_storage_path` string, nullable
          - `altitude_km` number, nullable
          - `repository_public` boolean
          - `event_public` boolean
          - `shared_event_keys` EphemerisViewer[], nullable
            - `ephemeris_id` string, uuid, nullable
            - `event_key_number` integer, nullable
          - `rso` RSORead
            - `id` string, uuid, required
            - `norad_id` integer, nullable
            - `international_designator` string, nullable
            - `object_type` string, nullable
            - `object_type_category` string, nullable
            - `object_name` string, nullable
          - `user_id` string, uuid, nullable
          - `group_id` string, uuid, nullable
          - `covariance_corrected` boolean, nullable
          - `source_ephemeris_id` string, uuid, nullable
          - `norad_id` integer, nullable
          - `ephemeris_source` 'CATALOG' | 'SPACE_TRACK_PUBLIC' | 'SPACE_TRACK_PUBLIC_SATCAT' | 'PATHFINDER_API' | 'SATCAT_API' | 'USER_SCREENER' | 'TERTIARY_SCREENER' | 'PATHFINDER_AUTO_THIRDPARTY' | 'KAYHAN_INTERNAL_PROCESS' | 'EXTRACTED_FROM_CDM' | 'PATHFINDER_SCREENER_THIRDPARTY' | 'STARLINK_API_PUBLIC' | 'PUBLIC_REPOSITORY' | 'STARLINK_STC_API', required
          - `solution_time` string, date-time, nullable
          - `has_covariance` boolean, required
          - `ephemeris_type` 'ON_ORBIT' | 'LAUNCH', required
          - `discontinuities` string[]
          - `comments` string, nullable
          - `apogee_km` number, required
          - `perigee_km` number, required
          - `archived` boolean
          - `hbr_m` number, nullable
          - `current_operational` boolean
          - `launch_time` string, date-time, nullable
          - `usable_time_start` string, date-time, nullable
          - `usable_time_end` string, date-time, nullable
          - `context` 'ROUTINE' | 'COLA' | 'MAINTENANCE' | 'NOVEL' | 'DECAY'
          - `designation` 'OPERATIONAL' | 'PREDICTIVE' | 'DEFINITIVE' | 'THEORETICAL' | 'TLE'
          - `catalog` CatalogMinimalRead
            - `ephemerides_count` integer, required
            - `id` string, uuid, required
            - `created_at` string, date-time, required
            - `catalog_type` 'SP' | 'TLE' | 'CUSTOM', required
            - `epoch` string, date-time, required
            - `archived` boolean
            - `filename` string, nullable
            - `ready` boolean
            - `data_format` string, nullable
            - `usable_time_start` string, date-time, nullable
            - `usable_time_end` string, date-time, nullable
            - `archive_protected` boolean
        - `catalog` CatalogPreviewWithEphemeridesCount
          - `id` string, uuid, required
          - `catalog_type` 'SP' | 'TLE' | 'CUSTOM', required
          - `epoch` string, date-time, required
          - `archived` boolean
          - `filename` string, nullable
          - `ready` boolean
          - `data_format` string, nullable
          - `usable_time_start` string, date-time, nullable
          - `usable_time_end` string, date-time, nullable
          - `archive_protected` boolean
          - `ephemerides_count` integer, required
        - `propagation` PropagationRead
          - `id` string, uuid, required
          - `created_at` string, date-time, nullable
          - `status` 'CREATED' | 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILURE' | 'CANCELED', required
          - `ephemeris_id` string, uuid, nullable
          - `start_time` string, date-time, nullable
          - `end_time` string, date-time, nullable
          - `started_at` string, date-time, nullable
          - `completed_at` string, date-time, nullable
          - `target_duration` number, nullable
          - `timestep` number, nullable
          - `enable_discontinuities` boolean
          - `maneuver_count` integer
          - `state_vector` StateVectorRead
            - `id` string, uuid, required
            - `norad_id` integer, nullable
            - `object_name` string, nullable
            - `pos_x` number, required
            - `pos_y` number, required
            - `pos_z` number, required
            - `pos_unit` string, required
            - `vel_x` number, required
            - `vel_y` number, required
            - `vel_z` number, required
            - `vel_unit` string, required
            - `timestamp` string, date-time, required
            - `frame` string, required
            - `mass` number, required
            - `coeff_drag` number, nullable
            - `coeff_rad` number, nullable
            - `area_drag` number, nullable
            - `area_rad` number, nullable
            - `covariance` CovarianceMatrixRead
              - …
          - `forces` ForceModelRead
            - `id` string, uuid, required
            - `earth_model` string, nullable
            - `geopotential` boolean
            - `geopotential_degree` integer, nullable
            - `geopotential_order` integer, nullable
            - `drag` boolean
            - `drag_model` string, nullable
            - `third_bodies` boolean
            - `third_bodies_list` string, nullable
            - `solid_tides` boolean
            - `solar_radiation_pressure` boolean
            - `ocean_tides` boolean
            - `oceantides_degree` integer, nullable
            - `oceantides_order` integer, nullable
          - `maneuvers` ManeuverRead[], nullable
            - `id` string, uuid, required
            - `type` string, required
            - `ignition_epoch` string, date-time, required
            - `delta_mass` number, nullable
            - `ref_frame` string, nullable
            - `deltav_x` number, nullable
            - `deltav_y` number, nullable
            - `deltav_z` number, nullable
            - `deltav_unit` string, nullable
            - `thrust_x` number, nullable
            - `thrust_y` number, nullable
            - `thrust_z` number, nullable
            - `thrust_unit` string, nullable
            - `duration` number, nullable
            - `specific_impulse` number, nullable
            - `rso_id` string, uuid, nullable
          - `tle` TLERead
            - `id` string, uuid, required
            - `object_name` string, nullable
            - `line1` string, nullable
            - `line2` string, nullable
          - `tle_id` string, uuid, nullable
          - `state_vector_id` string, uuid, nullable
          - `rso` RSORead
            - `id` string, uuid, required
            - `norad_id` integer, nullable
            - `international_designator` string, nullable
            - `object_type` string, nullable
            - `object_type_category` string, nullable
            - `object_name` string, nullable
      - `secondary_sources_preview` ScreenableRead[]
        - `id` string, uuid, required
        - `ephemeris_id` string, uuid, nullable
        - `catalog_id` string, uuid, nullable
        - `propagation_id` string, uuid, nullable
        - `ephemeris` EphemerisMetadataWithRSO
          - `id` string, uuid, nullable
          - `rso_id` string, uuid, nullable
          - `filename` string, nullable
          - `data_format` 'hdf5' | 'original' | 'gem'
          - `custom_storage_path` string, nullable
          - `altitude_km` number, nullable
          - `repository_public` boolean
          - `event_public` boolean
          - `shared_event_keys` EphemerisViewer[], nullable
            - `ephemeris_id` string, uuid, nullable
            - `event_key_number` integer, nullable
          - `rso` RSORead
            - `id` string, uuid, required
            - `norad_id` integer, nullable
            - `international_designator` string, nullable
            - `object_type` string, nullable
            - `object_type_category` string, nullable
            - `object_name` string, nullable
          - `user_id` string, uuid, nullable
          - `group_id` string, uuid, nullable
          - `covariance_corrected` boolean, nullable
          - `source_ephemeris_id` string, uuid, nullable
          - `norad_id` integer, nullable
          - `ephemeris_source` 'CATALOG' | 'SPACE_TRACK_PUBLIC' | 'SPACE_TRACK_PUBLIC_SATCAT' | 'PATHFINDER_API' | 'SATCAT_API' | 'USER_SCREENER' | 'TERTIARY_SCREENER' | 'PATHFINDER_AUTO_THIRDPARTY' | 'KAYHAN_INTERNAL_PROCESS' | 'EXTRACTED_FROM_CDM' | 'PATHFINDER_SCREENER_THIRDPARTY' | 'STARLINK_API_PUBLIC' | 'PUBLIC_REPOSITORY' | 'STARLINK_STC_API', required
          - `solution_time` string, date-time, nullable
          - `has_covariance` boolean, required
          - `ephemeris_type` 'ON_ORBIT' | 'LAUNCH', required
          - `discontinuities` string[]
          - `comments` string, nullable
          - `apogee_km` number, required
          - `perigee_km` number, required
          - `archived` boolean
          - `hbr_m` number, nullable
          - `current_operational` boolean
          - `launch_time` string, date-time, nullable
          - `usable_time_start` string, date-time, nullable
          - `usable_time_end` string, date-time, nullable
          - `context` 'ROUTINE' | 'COLA' | 'MAINTENANCE' | 'NOVEL' | 'DECAY'
          - `designation` 'OPERATIONAL' | 'PREDICTIVE' | 'DEFINITIVE' | 'THEORETICAL' | 'TLE'
          - `catalog` CatalogMinimalRead
            - `ephemerides_count` integer, required
            - `id` string, uuid, required
            - `created_at` string, date-time, required
            - `catalog_type` 'SP' | 'TLE' | 'CUSTOM', required
            - `epoch` string, date-time, required
            - `archived` boolean
            - `filename` string, nullable
            - `ready` boolean
            - `data_format` string, nullable
            - `usable_time_start` string, date-time, nullable
            - `usable_time_end` string, date-time, nullable
            - `archive_protected` boolean
        - `catalog` CatalogPreviewWithEphemeridesCount
          - `id` string, uuid, required
          - `catalog_type` 'SP' | 'TLE' | 'CUSTOM', required
          - `epoch` string, date-time, required
          - `archived` boolean
          - `filename` string, nullable
          - `ready` boolean
          - `data_format` string, nullable
          - `usable_time_start` string, date-time, nullable
          - `usable_time_end` string, date-time, nullable
          - `archive_protected` boolean
          - `ephemerides_count` integer, required
        - `propagation` PropagationRead
          - `id` string, uuid, required
          - `created_at` string, date-time, nullable
          - `status` 'CREATED' | 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILURE' | 'CANCELED', required
          - `ephemeris_id` string, uuid, nullable
          - `start_time` string, date-time, nullable
          - `end_time` string, date-time, nullable
          - `started_at` string, date-time, nullable
          - `completed_at` string, date-time, nullable
          - `target_duration` number, nullable
          - `timestep` number, nullable
          - `enable_discontinuities` boolean
          - `maneuver_count` integer
          - `state_vector` StateVectorRead
            - `id` string, uuid, required
            - `norad_id` integer, nullable
            - `object_name` string, nullable
            - `pos_x` number, required
            - `pos_y` number, required
            - `pos_z` number, required
            - `pos_unit` string, required
            - `vel_x` number, required
            - `vel_y` number, required
            - `vel_z` number, required
            - `vel_unit` string, required
            - `timestamp` string, date-time, required
            - `frame` string, required
            - `mass` number, required
            - `coeff_drag` number, nullable
            - `coeff_rad` number, nullable
            - `area_drag` number, nullable
            - `area_rad` number, nullable
            - `covariance` CovarianceMatrixRead
              - …
          - `forces` ForceModelRead
            - `id` string, uuid, required
            - `earth_model` string, nullable
            - `geopotential` boolean
            - `geopotential_degree` integer, nullable
            - `geopotential_order` integer, nullable
            - `drag` boolean
            - `drag_model` string, nullable
            - `third_bodies` boolean
            - `third_bodies_list` string, nullable
            - `solid_tides` boolean
            - `solar_radiation_pressure` boolean
            - `ocean_tides` boolean
            - `oceantides_degree` integer, nullable
            - `oceantides_order` integer, nullable
          - `maneuvers` ManeuverRead[], nullable
            - `id` string, uuid, required
            - `type` string, required
            - `ignition_epoch` string, date-time, required
            - `delta_mass` number, nullable
            - `ref_frame` string, nullable
            - `deltav_x` number, nullable
            - `deltav_y` number, nullable
            - `deltav_z` number, nullable
            - `deltav_unit` string, nullable
            - `thrust_x` number, nullable
            - `thrust_y` number, nullable
            - `thrust_z` number, nullable
            - `thrust_unit` string, nullable
            - `duration` number, nullable
            - `specific_impulse` number, nullable
            - `rso_id` string, uuid, nullable
          - `tle` TLERead
            - `id` string, uuid, required
            - `object_name` string, nullable
            - `line1` string, nullable
            - `line2` string, nullable
          - `tle_id` string, uuid, nullable
          - `state_vector_id` string, uuid, nullable
          - `rso` RSORead
            - `id` string, uuid, required
            - `norad_id` integer, nullable
            - `international_designator` string, nullable
            - `object_type` string, nullable
            - `object_type_category` string, nullable
            - `object_name` string, nullable
      - `primary_rsos_count` integer
      - `primary_rsos_preview` RSODetailedMetadataRead[]
        - `id` string, uuid, required
        - `norad_id` integer, nullable
        - `international_designator` string, nullable
        - `object_type` string, nullable
        - `object_type_category` string, nullable
        - `object_name` string, nullable
        - `rso_metadata` RSOMetadataRead
          - `norad_id` integer, nullable
          - `country` string, nullable
          - `satname` string, nullable
      - `secondary_rsos_count` integer
      - `secondary_rsos_preview` RSODetailedMetadataRead[]
        - `id` string, uuid, required
        - `norad_id` integer, nullable
        - `international_designator` string, nullable
        - `object_type` string, nullable
        - `object_type_category` string, nullable
        - `object_name` string, nullable
        - `rso_metadata` RSOMetadataRead
          - `norad_id` integer, nullable
          - `country` string, nullable
          - `satname` string, nullable
      - `propagations_count` integer
      - `schedule_id` string, uuid, nullable
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/satcat/apis/satcat-service-api.md) · [All operations](https://skmtc.net/satcat/apis/satcat-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/satcat/satcat-service-api/revisions/afeec2546de3/schema)