---
title: "List items in a collection"
method: GET
path: "/v0/archives/collections/{cid}/items"
tags: ["Archives"]
---

# List items in a collection

`GET /v0/archives/collections/{cid}/items`

List of items present in a collection

## Path parameters

- `cid` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- CosmosFeatureCollection
  - `type` string — The type of the collection
  - `features` CosmosItem[]
    - `id` string, required — The unique identifier of the item
    - `type` string — The type of the item
    - `collection` string — The collection the item belongs to
    - `stac_version` string — The version of the STAC specification
    - `stac_extensions` string[] — The extensions used in the item
    - `bbox` string[] — The bounding box of the item
    - `geometry` CosmosGeometry
      - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'GeometryCollection'
      - `coordinates` unknown
    - `properties` CosmosProperties
      - `altitude` number — The altitude of the sensor in meters
      - `constellation` string — The constellation name
      - `created` string — The date and time the item was created
      - `datetime` string
      - `description` string — A description of the item
      - `eo:cloud_cover` number — The percentage of the image covered by clouds
      - `gsd` number — The ground sample distance in meters
      - `instruments` string[] — The instruments used
      - `license` string — The license of the item
      - `platform` string — The platform name
      - `proj:code` string — The EPSG code of the projection
      - `proj:shape` integer[] — The shape of the projection
      - `proj:transform` number[] — the affine transform coefficients
      - `rd:anomalous_pixels` number — The percentage of anomalous pixels
      - `rd:earth_sun_distance` number — The distance between the Earth and the Sun
      - `rd:product_level` string — The product level
      - `rd:sat_id` string — The satellite ID
      - `rd:type` string — The type of radiometric data
      - `sci:doi` string — The DOI of the scientific publication
      - `startdatetime` string
      - `title` string — The title of the item
      - `updated` string — The date and time the item was last updated
      - `view:off_nadir` number — The angle between the sensor and the vertical
      - `view:scene_center_lat` number — The latitude of the center of the scene
      - `view:scene_center_lon` number — The longitude of the center of the scene
      - `view:sun_azimuth` number — The angle between the sun and the north
      - `view:sun_elevation` number — The angle between the sun and the horizon
    - `assets` object — Example ``` { "B091": { "href": "<path_to_asset>", "type": "image/tiff", "roles": ["data"], "title": "B091", "eo:bands": [ { "fwhm": 0, "name": "B091", "solar_irradiance": 1984.75, "center_wavelength": 490, "common_name": "red", } ], "raster:bands": [ { "scale": 0.00002, "nodata": 0, "offset": 0, "spatial_resolution": 30 } ] }, "B013": { "href": "<path_to_asset>", "type": "image/png", "roles": ["data"], "title": "B013", "eo:bands": [ { "fwhm": 0, "name": "B013", "common_name": "blue", "solar_irradiance": 1965.25, "center_wavelength": 493 } ], "raster:bands": [ { "scale": 0.00002, "nodata": 0, "offset": 0, "spatial_resolution": 30 } ] } } // The properties of the item
    - `links` CosmosLink[] — The links of the item
      - `href` string, required — The URL or reference the link points to
      - `rel` string, required — The relationship of the link (e.g., "self", "parent", "child")
      - `title` string — A human-readable title for the link
      - `type` string — The MIME type of the linked resource (e.g., "application/json")
  - `links` CosmosLink[]
    - `href` string, required — The URL or reference the link points to
    - `rel` string, required — The relationship of the link (e.g., "self", "parent", "child")
    - `title` string — A human-readable title for the link
    - `type` string — The MIME type of the linked resource (e.g., "application/json")

## 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/revisions/b501e2ca5a9d/schema)
