---
title: "Create Screening"
method: POST
path: "/screenings"
tags: ["Screening"]
---

# Create Screening

`POST /screenings`

Create a screening.
    Compares all points of the primary ephemerides which overlap in time with the
    resolved assigned secondaries, and identify close-approaches which may require
    the operator to perform collision avoidance action (conjunctions).
    <br/>
    Screenings are not automatically submitted for processing upon creation, unless the
    `submit` query parameter is used. Screenings can be further configured using the
    various `/screenings/{id}` endpoints and then submitted for processing using
    `PUT /screenings/{id}/submit`.
    <br/>
    Because Screenings are processed in a queue, screening is an asynchronous operation.
    The status and results of a submitted  screening can be found by retrieving
    the Screening using `GET /screenings/{id}`.

## Query parameters

- `submit` boolean — Whether to automatically submit the screening for processing upon creation. If not used, the screening can be further configured and later submitted using the screening actions subresources.
- `group_id` string, uuid, nullable — Optional group ID to use for the request

## Request body

- ScreeningCreate
  - `group_id` string, uuid, nullable
  - `threshold_radius_km` number
  - `threshold_radius_manned_km` number, nullable
  - `threshold_radius_active_km` number, nullable
  - `threshold_radius_debris_km` number, nullable
  - `default_secondary_hbr_m` number
  - `auto_archive` boolean
  - `include_primary_vs_primary` boolean
  - `title` string, nullable
  - `notes` string, nullable
  - `screening_type` 'ON_ORBIT' | 'LAUNCH'
  - `launch_window_start` string, date-time, nullable
  - `launch_window_end` string, date-time, nullable
  - `launch_window_cadence_s` integer, nullable
  - `hard_body_shape` 'SQUARE' | 'CIRCLE'
  - `strict_coverage` boolean
  - `publish_cdms` boolean, nullable
  - `primaries` ScreenableCreate[], nullable
    - `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
  - `secondaries` ScreenableCreate[], nullable
    - `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
  - `schedule_id` string, uuid, nullable

## Response `201`

Successful Response

- ScreeningReadMinimal
  - `id` string, uuid, required
  - `title` string, required
  - `notes` string, 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

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