---
title: "List Ground Observers"
method: GET
path: "/ground_observers"
tags: ["Mission Planning"]
---

# List Ground Observers

`GET /ground_observers`

List saved ground observers for the request group.

## Query parameters

- `tags` string[], nullable — Only return saved ground observers containing all specified tags. Repeat this query parameter to pass multiple tags.
- `group_id` string, uuid, nullable — Optional group ID to use for the request
- `offset` integer
- `count` integer

## Response `200`

Successful Response

- OffsetPageResultGroundObserverRead
  - `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` GroundObserverRead[], required
    - `sensor_id` string, required
    - `name` string, nullable
    - `tags` string[], required
    - `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
    - `id` string, uuid, required
    - `group_id` string, uuid, nullable, required
    - `public` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `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/versions/afeec2546de3/schema)