---
title: "Submit Screening"
method: PUT
path: "/screenings/{id}/submit"
tags: ["Screening"]
---

# Submit Screening

`PUT /screenings/{id}/submit`

Submit a screening for processing. Submitting a screening is an idempotent operation. Once a screening has been submitted and entered the PENDING state, submitting it again will have no further effect. <br/> If the screening as configured at submission fails validation, the server will return HTTP status 422 (Unprocessable Entity) and the screening will not enter the PENDING state until the configuration is updated and the screening is submitted again.

## Path parameters

- `id` string, uuid, required

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