GET /v1/collections/{collectionId}/items
The OGC API Features view of one collection.
| Method and path | GET /v1/collections/{collectionId}/items |
| Key | needed |
| Response | application/geo+json, a FeatureCollection of STAC items |
| Lean OpenAPI | listItems |
| Full contract | listItems |
Parameters
Section titled “Parameters”| Name | In | Meaning |
|---|---|---|
collectionId |
path | canonical id or alias |
bbox |
query | west,south,east,north in longitude and latitude, for example -93.3,44.9,-93.2,45.0 |
datetime |
query | RFC 3339 instant or interval, for example 2026-06-01T00:00:00Z/2026-08-31T23:59:59Z |
limit |
query | page size, 1 to 1,000, default 10 |
token |
query | paging token from a next link |
sortby |
query | sort fields, such as -properties.eo:cloud_cover or +datetime |
fields |
query | fields to include or exclude |
query |
query | the STAC query extension as JSON, such as {"eo:cloud_cover":{"lte":20}} (URL-encoded) |
Unknown query parameters are rejected with 400 invalid-parameter.
Items come from Earth Search with their native ids, and every link is rewritten to point at api.satellitedata.net/v1. Follow the next link for more.
Example
Section titled “Example”curl -s "https://api.satellitedata.net/v1/collections/sentinel-2-l2a/items?bbox=-93.3,44.9,-93.2,45.0&datetime=2026-07-01T00:00:00Z/2026-07-31T23:59:59Z&limit=5" \ -H "X-API-Key: $SDN_API_KEY"Errors
Section titled “Errors”| Status | Code | When |
|---|---|---|
| 400 | invalid-parameter |
a malformed or unknown parameter |
| 400 | invalid-filter |
a CQL2 filter, which lean v1 does not support |
| 401 | invalid-key |
no key or an unknown key |
| 404 | unknown-collection |
no such collection |
| 429 | rate-limited, quota-exhausted |
over the rate or monthly limit |
| 503 | upstream-unavailable |
Earth Search did not answer |
Coming later
Section titled “Coming later”filter (CQL2) and anonymous access under per-IP limits.