---
title: "Add Screening Secondary"
method: POST
path: "/screenings/{id}/secondaries"
tags: ["Screening"]
---

# Add Screening Secondary

`POST /screenings/{id}/secondaries`

Add a Screenable to the list of secondaries for a screening. If `norad_cat_id` is specified, must also be specified alongside `catalog_id`, and signifies that the ephemeris for object `norad_cat_id` from catalog `catalog_id` should be added. If `catalog_id` is specified alone, signifies that the whole catalog should be used.

## Path parameters

- `id` string, uuid, required

## Request body

- ScreenableCreate
  - `ephemeris_id` string, uuid, nullable
  - `catalog_id` string, uuid, nullable
  - `propagation_id` string, uuid, nullable
  - `ephemeris_group` 'OPERATOR_REPOSITORY' | 'TASKING_REPOSITORY'
  - `norad_id` integer, nullable

## Response `200`

Successful Response

- ScreeningRead
  - `id` string, uuid, required
  - `group_id` string, uuid, nullable
  - `owner` UserProfilePreview
    - `id` string, uuid, required
    - `username` string, nullable
    - `full_name` string, nullable
    - `avatar_url` string, nullable
    - `email` string, nullable
  - `status` 'CREATED' | 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILURE' | 'CANCELED', required
  - `started_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `threshold_radius_km` number, required
  - `threshold_radius_manned_km` number, nullable
  - `threshold_radius_active_km` number, nullable
  - `threshold_radius_debris_km` number, nullable
  - `default_secondary_hbr_m` number, required
  - `auto_archive` boolean, required
  - `include_primary_vs_primary` boolean, required
  - `title` string, nullable
  - `notes` string, nullable
  - `screening_type` 'ON_ORBIT' | 'LAUNCH', required
  - `hard_body_shape` 'SQUARE' | 'CIRCLE', required
  - `strict_coverage` boolean, required
  - `publish_cdms` boolean, required
  - `screen_count_expected` integer, nullable
  - `screen_count_current` integer, nullable
  - `launch_window_start` string, date-time, nullable
  - `launch_window_end` string, date-time, nullable
  - `launch_window_cadence_s` integer, nullable
  - `archived` boolean, required
  - `percent_complete` number, required
  - `primary_sources_count` integer, required
  - `secondary_sources_count` integer, required
  - `primaries_count` integer, nullable
  - `secondaries_count` integer, nullable
  - `lowest_miss_distance_km` number, nullable
  - `highest_pc` number, nullable
  - `next_tca` string, date-time, nullable
  - `propagation_start_time` string, date-time, nullable
  - `propagation_duration_s` number, nullable
  - `propagation_timestep_s` number, nullable
  - `secondary_any_coverage_end` string, date-time, nullable
  - `secondary_any_coverage_start` string, date-time, nullable
  - `secondary_full_coverage_end` string, date-time, nullable
  - `secondary_full_coverage_start` string, date-time, nullable
  - `failure_message` 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)