---
title: "Get Conjunction Message Tracking Opportunities By Id"
method: GET
path: "/tracking_opportunities/{cdm_id}"
tags: ["Plot"]
---

# Get Conjunction Message Tracking Opportunities By Id

`GET /tracking_opportunities/{cdm_id}`

Retrieve tracking opportunity visibility windows for CDM by CDM ID.

## Path parameters

- `cdm_id` string, required — ID of conjunction message

## Response `200`

Successful Response

- TrackingOpportunities
  - `primary` ObjectTrackingOpportunities
    - `ephemeris_id` string, required
    - `request` VisibilityWindowsRequest, required
      - `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.
              - …
          - 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
    - `result` VisibilityWindowsResult, required
      - `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
  - `secondary` ObjectTrackingOpportunities
    - `ephemeris_id` string, required
    - `request` VisibilityWindowsRequest, required
      - `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.
              - …
          - 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
    - `result` VisibilityWindowsResult, required
      - `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)