---
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
    - `recommendation_jsonb` object, nullable
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-26** `3af6a1633d06` — 3 warning
  - removed the optional property `items/items/collision_probability_valid` from the response with the `200` status
  - removed the optional property `items/items/failing_vailidity_cause` from the response with the `200` status
  - removed the optional property `items/items/pc_validity_state` from the response with the `200` status

[Change history](https://skmtc.dev/satcat/apis/satcat-service-api/changes/conjunction_messages/get.md)

---

[API](https://skmtc.dev/satcat/apis/satcat-service-api.md) · [All operations](https://skmtc.dev/satcat/apis/satcat-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/satcat/satcat-service-api/revisions/3af6a1633d06/schema)