---
title: "Get item"
method: GET
path: "/v0/archives/collections/{cid}/items/{id}"
tags: ["Archives"]
---

# Get item

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

## Request

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

Get a STAC item by it's collection and item ID

## Path parameters

- `cid` string, required
- `id` string, required

## Response `200`

OK

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

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)