GET /v1/collections/{collectionId}
Returns one collection by canonical id or alias.
| Method and path | GET /v1/collections/{collectionId} |
| Key | not needed |
| Response | application/json, a STAC Collection |
| Lean OpenAPI | getCollection |
| Full contract | getCollection |
Path parameters
Section titled “Path parameters”| Name | Meaning |
|---|---|
collectionId |
sentinel-2-l2a or landsat-ot-l2, or any schema v1 alias without a slash, such as S2L2A, sentinel-2-c1-l2a, landsat-c2-l2 or LOTL2 (case-insensitive) |
An alias answers 200 with the canonical document and a Content-Location header pointing at the canonical URL.
Example
Section titled “Example”curl -s -i https://api.satellitedata.net/v1/collections/sentinel-2-c1-l2aResponse
Section titled “Response”A STAC collection with the eo and raster extensions, plus members from schema v1 under the sdn: prefix, such as:
| Member | Meaning |
|---|---|
sdn:aliases |
ids that also name this collection |
sdn:attribution |
the credit line to show with any output, with {years} to fill in |
extent is the collection’s spatial and temporal extent. The band table follows schema v1; see Bands and the crosswalk.
Errors
Section titled “Errors”| Status | Code | When |
|---|---|---|
| 404 | unknown-collection |
the id is not a collection or alias |
| 500 | internal |