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

# Get a catalog

`GET /v0/catalogs/{id}`

Get a single catalog by ID

## Path parameters

- `id` string, required

## Response `200`

OK

- ClerkCatalog
  - `area` number — area of the catalog in sq. km
  - `bandset_id` string — id of the bandset present in the catalog
  - `created_at` string — timestamp of the creation of the catalog
  - `created_by` string — uuid of the user who created the catalog
  - `delivery_status` 'UNSPECIFIED' | 'CREATED' | 'FAILED' | 'IN_PROGRESS' | 'SUCCESS'
  - `details` ClerkSTACItem
    - `assets` object
    - `bbox` number[] — bounding box of the STAC item
    - `collection` string
    - `geometry` ClerkGeometry
      - `coordinates` array[]
        - array[]
          - number[]
      - `type` string
    - `id` string — id of the STAC item, also referred as item_id
    - `links` ClerkLink[]
      - `href` string
      - `rel` string
      - `title` string
      - `type` string
    - `properties` ClerkProperties
      - `constellation` string — name of the constellation
      - `created` string — timestamp of the creation of the image
      - `datetime` string — timestamp of the image
      - `eo:cloud_cover` number — cloud cover percentage
      - `gsd` integer — ground sample distance
      - `instruments` string[] — list of instruments
      - `platform` string — name of the platform
      - `proj:epsg` integer — EPSG code of the projection
      - `proj:shape` integer[] — shape of the projection
      - `proj:transform` number[] — transform of the projection
      - `proj:wkt2` string — WKT2 of the projection
      - `sat:orbit_state` string — orbit state of the satellite
      - `sat:relative_orbit` integer — relative orbit number of the satellite
      - `sci:doi` string — DOI of the scientific publication
      - `updated` string — timestamp of the last update of the image
      - `view:off_nadir` number — off nadir angle of the satellite
      - `view:satellite_look_angle` number — look angle of the satellite
      - `view:sun_azimuth` number — azimuth angle of the sun
      - `view:sun_elevation` number — elevation angle of the sun
    - `stac_extensions` unknown[] — list of extensions used in the STAC item
      - unknown
    - `stac_version` string — version of the STAC standard used
    - `type` string — type of the STAC item
  - `id` string — id of the catalog
  - `org_id` string — id of the workspace to which the catalog belongs
  - `task_id` string — id of the task, whose catalog this resource tracks
  - `updated_at` string — timestamp of the last update of the catalog
  - `updated_by` string — uuid of the user who last updated the catalog

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/pixxel/apis/stargate.md) · [All operations](https://skmtc.net/pixxel/apis/stargate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pixxel/stargate/versions/b501e2ca5a9d/schema)
