---
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`

## Request

- Base URL: `https://api.pixxel.space`
- URL: `https://api.pixxel.space/v0/archives/collections/{cid}/items`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/pixxel/apis/stargate/docs/v0/archives/collections/:cid/items/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/pixxel/apis/stargate.md) - [All operations](https://skmtc.dev/pixxel/apis/stargate/llms.txt) - [OpenAPI document](https://skmtc.dev/pixxel/apis/stargate/revisions/519562bd9d7a?raw)