---
title: "Get Conjunction Message Collision Consequence Tradespace By Id"
method: GET
path: "/collision_consequence/{cdm_id}"
tags: ["Plot"]
---

# Get Conjunction Message Collision Consequence Tradespace By Id

`GET /collision_consequence/{cdm_id}`

Retrieve collision consequence tradespace data for CDM by CDM ID.

## Path parameters

- `cdm_id` string, required — ID of conjunction message

## Query parameters

- `num_points` integer — Optional number of points for the tradespace calculation.
- `characteristic_length_m` number — Optional characterstic length in meters for debris calculation.

## Response `200`

Successful Response

- CollisionConsequenceTradespace
  - `points` CollisionConsequenceTradespacePoint[], required
    - `relative_velocity_km_s` number, required
    - `secondary_mass_kg` number, required
    - `num_debris_objects` number, required
    - `is_nominal` boolean
  - `nominal_relative_velocity_km_s` number, required
  - `nominal_primary_mass_kg` number, required
  - `nominal_secondary_mass_kg` number, nullable, required
  - `primary_mass_source` string, nullable

## 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)