---
title: "Get Catalog"
method: GET
path: "/catalogs/{id}"
tags: ["Catalog"]
---

# Get Catalog

`GET /catalogs/{id}`

Retrieve metadata about a catalog.

## Path parameters

- `id` string, required — ID of the catalog to get

## Response `200`

Successful Response

- CatalogPreviewRead
  - `ephemerides_count` integer, required
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `catalog_type` 'SP' | 'TLE' | 'CUSTOM', required
  - `epoch` string, date-time, required
  - `archived` boolean
  - `filename` string, nullable
  - `ready` boolean
  - `data_format` string, nullable
  - `usable_time_start` string, date-time, nullable
  - `usable_time_end` string, date-time, nullable
  - `archive_protected` boolean
  - `ephemerides_preview` EphemerisMetadataWithRSO[], required
    - `id` string, uuid, nullable
    - `rso_id` string, uuid, nullable
    - `filename` string, nullable
    - `data_format` 'hdf5' | 'original' | 'gem'
    - `custom_storage_path` string, nullable
    - `altitude_km` number, nullable
    - `repository_public` boolean
    - `event_public` boolean
    - `shared_event_keys` EphemerisViewer[], nullable
      - `ephemeris_id` string, uuid, nullable
      - `event_key_number` integer, nullable
    - `rso` RSORead
      - `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
    - `user_id` string, uuid, nullable
    - `group_id` string, uuid, nullable
    - `covariance_corrected` boolean, nullable
    - `source_ephemeris_id` string, uuid, nullable
    - `norad_id` integer, nullable
    - `ephemeris_source` 'CATALOG' | 'SPACE_TRACK_PUBLIC' | 'SPACE_TRACK_PUBLIC_SATCAT' | 'PATHFINDER_API' | 'SATCAT_API' | 'USER_SCREENER' | 'TERTIARY_SCREENER' | 'PATHFINDER_AUTO_THIRDPARTY' | 'KAYHAN_INTERNAL_PROCESS' | 'EXTRACTED_FROM_CDM' | 'PATHFINDER_SCREENER_THIRDPARTY' | 'STARLINK_API_PUBLIC' | 'PUBLIC_REPOSITORY' | 'STARLINK_STC_API', required
    - `solution_time` string, date-time, nullable
    - `has_covariance` boolean, required
    - `ephemeris_type` 'ON_ORBIT' | 'LAUNCH', required
    - `discontinuities` string[]
    - `comments` string, nullable
    - `apogee_km` number, required
    - `perigee_km` number, required
    - `archived` boolean
    - `hbr_m` number, nullable
    - `current_operational` boolean
    - `launch_time` string, date-time, nullable
    - `usable_time_start` string, date-time, nullable
    - `usable_time_end` string, date-time, nullable
    - `context` 'ROUTINE' | 'COLA' | 'MAINTENANCE' | 'NOVEL' | 'DECAY'
    - `designation` 'OPERATIONAL' | 'PREDICTIVE' | 'DEFINITIVE' | 'THEORETICAL' | 'TLE'
    - `catalog` CatalogMinimalRead
      - `ephemerides_count` integer, required
      - `id` string, uuid, required
      - `created_at` string, date-time, required
      - `catalog_type` 'SP' | 'TLE' | 'CUSTOM', required
      - `epoch` string, date-time, required
      - `archived` boolean
      - `filename` string, nullable
      - `ready` boolean
      - `data_format` string, nullable
      - `usable_time_start` string, date-time, nullable
      - `usable_time_end` string, date-time, nullable
      - `archive_protected` boolean
  - `object_overview` CatalogObjectOverview, required
    - `leo` OrbitRegimeOverview, required
      - `total_count` integer, required
      - `deb_count` integer, required
      - `total_count_percent_change_month` number, nullable
    - `meo` OrbitRegimeOverview, required
      - `total_count` integer, required
      - `deb_count` integer, required
      - `total_count_percent_change_month` number, nullable
    - `geo` OrbitRegimeOverview, required
      - `total_count` integer, required
      - `deb_count` integer, required
      - `total_count_percent_change_month` number, 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)