---
title: "Get All Propagations"
method: GET
path: "/propagations"
tags: ["Propagation"]
---

# Get All Propagations

`GET /propagations`

Retrieve all propagation jobs.

## Query parameters

- `filters` string, nullable
- `sort_field` string
- `sort_direction` 'asc' | 'desc'
- `offset` integer
- `count` integer
- `group_id` string, uuid, nullable — Optional group ID to use for the request

## Response `201`

Successful Response

- OffsetPageResultPropagationRead
  - `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` PropagationRead[], required
    - `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
        - `data` number[], required
        - `format` string, required
        - `frame` string, required
        - `length_unit` string, required
    - `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
  - `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)