---
title: "List Conjunction Messages"
method: GET
path: "/conjunction_messages"
tags: ["Conjunction"]
---

# List Conjunction Messages

`GET /conjunction_messages`

List the conjunction messages to which the currently authenticated user has read access.

## Query parameters

- `latest_for` string — key or cdm_id of conjunction message to get latest data for
- `history_for` string — key or cdm_id of conjunction message to get history data for
- `operational` boolean — Whether to include only CDMs with designation 'OPERATIONAL' in the result; defaults to true
- `filters` string, nullable
- `sort_field` string
- `sort_direction` 'asc' | 'desc'
- `offset` integer
- `count` integer
- `fields` string

## Response `200`

Successful Response

- OffsetPageResultConjunctionListRead
  - `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` ConjunctionListRead[], required
    - `key` string, required
    - `cdm_id` integer, nullable
    - `primary` RSORead, required
      - `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
    - `secondary` RSORead, required
      - `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
    - `miss_distance_km` number, required
    - `event_id` string, uuid, nullable
    - `creation_date` string, date-time, required
    - `originator` string, nullable
    - `tca` string, date-time, required
    - `collision_probability` number, nullable
    - `collision_probability_method` string, nullable
    - `original_collision_probability_method` string, nullable
    - `original_collision_probability` number, nullable
    - `collision_probability_valid` boolean, nullable
    - `failing_vailidity_cause` 'NULL' | 'LOW_DV' | 'DILUTION' | 'MANUAL' | 'VIOLATION' | 'SINGLE_COVARIANCE'
    - `pc_validity_state` 'PC has been calculated and is available.' | 'PC calculation is in process.' | 'There was a problem calculating PC. Defaulting to the invalid value.' | 'Current PC is invalid for some reason.'
    - `recommendation_jsonb` object, 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/revisions/afeec2546de3/schema)