---
title: "List Visibility Windows"
method: POST
path: "/visibility_windows"
tags: ["Mission Planning"]
---

# List Visibility Windows

`POST /visibility_windows`

List predicted visibility windows given an input scenario.

## Query parameters

- `group_id` string, uuid, nullable — Optional group ID to use for the request

## Request body

- VisibilityWindowsRequest
  - `primary_rso_data_source` union, required — Data source for the RSO state.
    - VisibilityRequestTLEDataSource
      - `source_type` 'TLE'
      - `line1` string, required
      - `line2` string, required
      - `propagation_start_time` string, date-time, nullable
      - `propagation_stop_time` string, date-time, nullable
    - VisibilityRequestEphemerisDataSource
      - `source_type` 'EPHEMERIS'
      - `ephemeris_id` string, required
  - `observers` VisibilityRequestObserver[], required
    - `id` string, required
    - `name` string, nullable
    - `definition` union, required — Observer definition.
      - UDLGroundSensorDefinition
        - `source_type` 'UDL_GROUND_SENSOR'
        - `ground_sensor` UDLGroundSensor, required — Compatible with the UDL GroundSensor model. Can be used for both ground stations and ground sensors such as radar / EO.
          - `sensorName` string, required
          - `idSensor` string, required
          - `source` string, required
          - `classificationMarking` string, required
          - `entity` UDLGroundSensorEntity, required
            - `location` UDLGroundSensorLocation, required
              - …
          - `sensorcharacteristics` UDLSensorCharacteristic[], nullable, required
            - `minRangeLimit` number, nullable
            - `maxRangeLimit` number, nullable
            - `maxSunElevationAngle` number, nullable
          - `sensorlimitsCollection` UDLSensorAzElLimit[], nullable, required
            - `upperLeftAzimuthLimit` number, nullable
            - `upperRightAzimuthLimit` number, nullable
            - `lowerLeftAzimuthLimit` number, nullable
            - `lowerRightAzimuthLimit` number, nullable
            - `upperLeftElevationLimit` number, nullable
            - `upperRightElevationLimit` number, nullable
            - `lowerLeftElevationLimit` number, nullable
            - `lowerRightElevationLimit` number, nullable
      - GroundStationDefinition
        - `source_type` 'GROUND_STATION'
        - `latitude_deg` number, required
        - `longitude_deg` number, required
        - `altitude_m` number, required
        - `min_elevation_deg` number, nullable
      - SavedObserverSearchDefinition
        - `source_type` 'SAVED_OBSERVER_SEARCH'
        - `owner` 'group' | 'public'
        - `tags` string[], required

## Response `200`

Successful Response

- VisibilityWindowsResult
  - `windows` VisibilityWindow[], required
    - `aos_time` string, date-time, nullable
    - `aos_el_deg` number, nullable
    - `los_time` string, date-time, nullable
    - `los_el_deg` number, nullable
    - `max_el_time` string, date-time, nullable
    - `max_el_deg` number, nullable
    - `observer_id` string, required
    - `duration_s` number, nullable, 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)