---
title: "List Events"
method: GET
path: "/events"
tags: ["Conjunction"]
---

# List Events

`GET /events`

List the events 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

- OffsetPageResultEventRead
  - `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` EventRead[], required
    - `id` string, uuid, required
    - `key` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `tca_range_start` string, date-time, required
    - `tca_range_end` string, date-time, required
    - `auto_intent_enabled` boolean, required
    - `default_cdm` ConjunctionRead, required
      - `id` string, uuid, nullable
      - `key` string, nullable
      - `event_id` string, uuid, nullable
      - `event` EventReadSimple
        - `id` string, uuid, required
        - `key` string, required
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `designation` 'OPERATIONAL' | 'THEORETICAL' | 'PREDICTED' | 'DEFINITIVE', required
      - `cdm_id` integer, nullable
      - `key_number` integer, required
      - `filename` string, nullable
      - `insert_epoch` string, date-time, required
      - `creation_date` string, date-time, required
      - `originator` string, nullable
      - `tca` string, date-time, required
      - `miss_distance_km` number, required
      - `relative_velocity_mag_km_s` number, required
      - `relative_position_r_km` number, required
      - `relative_position_i_km` number, required
      - `relative_position_c_km` number, required
      - `relative_velocity_r_km_s` number, required
      - `relative_velocity_i_km_s` number, required
      - `relative_velocity_c_km_s` number, required
      - `comment_screening_option` string, nullable
      - `collision_probability` number, nullable
      - `collision_probability_method` string, nullable
      - `frisbee_collision_probability` number, nullable
      - `frisbee_collision_probability_method` string, nullable
      - `original_collision_probability` number, nullable
      - `original_collision_probability_method` string, nullable
      - `primary_rso_id` string, uuid, required
      - `secondary_rso_id` string, uuid, required
      - `angle_of_approach` number, nullable
      - `mahalanobis_distance` number, nullable
      - `relative_miss_sig_m` number, nullable
      - `relative_sig_r_u_m` number, nullable
      - `relative_sig_it_u_m` number, nullable
      - `relative_sig_ct_u_m` number, nullable
      - `primary` 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` 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
      - `is_intra_org` boolean, required
      - `recommendation_jsonb` object, nullable
      - `primary_state` SpacecraftConjunctionStateRead
        - `id` string, uuid, nullable
        - `created_at` string, date-time, nullable
        - `comment_screening_data_source` string, nullable
        - `ephemeris_name` string, nullable
        - `covariance_method` string, nullable
        - `ref_frame` string, nullable
        - `gravity_model` string, nullable
        - `atmospheric_model` string, nullable
        - `n_body_perturbations` string, nullable
        - `solar_rad_pressure` string, nullable
        - `earth_tides` string, nullable
        - `intrack_thrust` string, nullable
        - `comment_covariance_scale_factor` string, nullable
        - `comment_exclusion_volume_radius` string, nullable
        - `hbr_m` number, nullable
        - `time_lastob_start` string, date-time, nullable
        - `time_lastob_end` string, date-time, nullable
        - `recommended_od_span` number, nullable
        - `actual_od_span` number, nullable
        - `obs_available` integer, nullable
        - `obs_used` integer, nullable
        - `tracks_available` integer, nullable
        - `tracks_used` integer, nullable
        - `residuals_accepted` integer, nullable
        - `weighted_rms` number, nullable
        - `od_quality_rating` object, nullable
        - `comment_apogee` string, nullable
        - `comment_perigee` string, nullable
        - `comment_inclination` string, nullable
        - `comment_operator_hard_body_radius` string, nullable
        - `area_pc` number, nullable
        - `cd_area_over_mass` number, nullable
        - `cr_area_over_mass` number, nullable
        - `thrust_acceleration_m` number, nullable
        - `sedr` number, nullable
        - `x_km` number, required
        - `y_km` number, required
        - `z_km` number, required
        - `x_dot_km` number, required
        - `y_dot_km` number, required
        - `z_dot_km` number, required
        - `comment_dcp_density_forecast_uncertainty` string, nullable
        - `comment_dcp_sensitivity_vector_position` string, nullable
        - `comment_dcp_sensitivity_vector_velocity` string, nullable
        - `cr_r` number, nullable
        - `ct_r` number, nullable
        - `ct_t` number, nullable
        - `cn_r` number, nullable
        - `cn_t` number, nullable
        - `cn_n` number, nullable
        - `crdot_r` number, nullable
        - `crdot_t` number, nullable
        - `crdot_n` number, nullable
        - `crdot_rdot` number, nullable
        - `ctdot_r` number, nullable
        - `ctdot_t` number, nullable
        - `ctdot_n` number, nullable
        - `ctdot_rdot` number, nullable
        - `ctdot_tdot` number, nullable
        - `cndot_r` number, nullable
        - `cndot_t` number, nullable
        - `cndot_n` number, nullable
        - `cndot_rdot` number, nullable
        - `cndot_tdot` number, nullable
        - `cndot_ndot` number, nullable
        - `cdrg_r` number, nullable
        - `cdrg_t` number, nullable
        - `cdrg_n` number, nullable
        - `cdrg_rdot` number, nullable
        - `cdrg_tdot` number, nullable
        - `cdrg_ndot` number, nullable
        - `cdrg_drg` number, nullable
        - `csrp_r` number, nullable
        - `csrp_t` number, nullable
        - `csrp_n` number, nullable
        - `csrp_rdot` number, nullable
        - `csrp_tdot` number, nullable
        - `csrp_ndot` number, nullable
        - `csrp_drg` number, nullable
        - `csrp_srp` number, nullable
        - `ephemeris_id` string, uuid, nullable
        - `screening_id` string, uuid, nullable
        - `derived_from_spacecraft_state_id` string, uuid, nullable
        - `rso_id` string, uuid, nullable
        - `altitude_km` number, nullable
      - `secondary_state` SpacecraftConjunctionStateRead
        - `id` string, uuid, nullable
        - `created_at` string, date-time, nullable
        - `comment_screening_data_source` string, nullable
        - `ephemeris_name` string, nullable
        - `covariance_method` string, nullable
        - `ref_frame` string, nullable
        - `gravity_model` string, nullable
        - `atmospheric_model` string, nullable
        - `n_body_perturbations` string, nullable
        - `solar_rad_pressure` string, nullable
        - `earth_tides` string, nullable
        - `intrack_thrust` string, nullable
        - `comment_covariance_scale_factor` string, nullable
        - `comment_exclusion_volume_radius` string, nullable
        - `hbr_m` number, nullable
        - `time_lastob_start` string, date-time, nullable
        - `time_lastob_end` string, date-time, nullable
        - `recommended_od_span` number, nullable
        - `actual_od_span` number, nullable
        - `obs_available` integer, nullable
        - `obs_used` integer, nullable
        - `tracks_available` integer, nullable
        - `tracks_used` integer, nullable
        - `residuals_accepted` integer, nullable
        - `weighted_rms` number, nullable
        - `od_quality_rating` object, nullable
        - `comment_apogee` string, nullable
        - `comment_perigee` string, nullable
        - `comment_inclination` string, nullable
        - `comment_operator_hard_body_radius` string, nullable
        - `area_pc` number, nullable
        - `cd_area_over_mass` number, nullable
        - `cr_area_over_mass` number, nullable
        - `thrust_acceleration_m` number, nullable
        - `sedr` number, nullable
        - `x_km` number, required
        - `y_km` number, required
        - `z_km` number, required
        - `x_dot_km` number, required
        - `y_dot_km` number, required
        - `z_dot_km` number, required
        - `comment_dcp_density_forecast_uncertainty` string, nullable
        - `comment_dcp_sensitivity_vector_position` string, nullable
        - `comment_dcp_sensitivity_vector_velocity` string, nullable
        - `cr_r` number, nullable
        - `ct_r` number, nullable
        - `ct_t` number, nullable
        - `cn_r` number, nullable
        - `cn_t` number, nullable
        - `cn_n` number, nullable
        - `crdot_r` number, nullable
        - `crdot_t` number, nullable
        - `crdot_n` number, nullable
        - `crdot_rdot` number, nullable
        - `ctdot_r` number, nullable
        - `ctdot_t` number, nullable
        - `ctdot_n` number, nullable
        - `ctdot_rdot` number, nullable
        - `ctdot_tdot` number, nullable
        - `cndot_r` number, nullable
        - `cndot_t` number, nullable
        - `cndot_n` number, nullable
        - `cndot_rdot` number, nullable
        - `cndot_tdot` number, nullable
        - `cndot_ndot` number, nullable
        - `cdrg_r` number, nullable
        - `cdrg_t` number, nullable
        - `cdrg_n` number, nullable
        - `cdrg_rdot` number, nullable
        - `cdrg_tdot` number, nullable
        - `cdrg_ndot` number, nullable
        - `cdrg_drg` number, nullable
        - `csrp_r` number, nullable
        - `csrp_t` number, nullable
        - `csrp_n` number, nullable
        - `csrp_rdot` number, nullable
        - `csrp_tdot` number, nullable
        - `csrp_ndot` number, nullable
        - `csrp_drg` number, nullable
        - `csrp_srp` number, nullable
        - `ephemeris_id` string, uuid, nullable
        - `screening_id` string, uuid, nullable
        - `derived_from_spacecraft_state_id` string, uuid, nullable
        - `rso_id` string, uuid, nullable
        - `altitude_km` number, 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)
