Landing page with links (STAC API root)

GET

/v1

const url = 'https://api.satellitedata.net/v1';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.satellitedata.net/v1

Returns the STAC API landing page: the catalog id, the conformance classes the API implements, and links to collections, search, queryables, the OpenAPI document and the docs. STAC clients such as pystac-client start here. Free, anonymous and cached for 10 minutes at CloudFront.

Responses

200

Landing page.

application/json

STAC API landing page.

object

type

required

Always Catalog.

string

Allowed value: Catalog

required

Catalog id.

string

title

Catalog title.

string

description

required

Catalog description.

string

stac_version

required

STAC version of the API.

string

conformsTo

required

Conformance class URIs, also served at /v1/conformance.

Array<string>

sdn:schemaVersion

Version of schema v1 behind the API, as in GET /v1/schema.

string

links

required

Links to every top-level resource.

Array<object>

A STAC and OGC API link object.

object

href

required

Link target.

string format: uri

rel

required

Relation type, such as self, root, parent, next, prev, items, queryables, tiles or license.

string

type

Media type of the target.

string

title

Human-readable title.

string

method

HTTP method for the link, GET unless stated. Paging POST /v1/search uses POST.

string

Allowed values: GET POST

body

Request body to send with a POST link, used for the next page of POST /v1/search.

object

key

additional properties

any

merge

When true the client merges body into the previous request body.

boolean

Example

{
  "type": "Catalog",
  "id": "satellitedata-net",
  "title": "satellitedata.net",
  "description": "Free unified API for Sentinel and Landsat pixels.",
  "stac_version": "1.1.0",
  "conformsTo": [
    "https://api.stacspec.org/v1.0.0/core",
    "https://api.stacspec.org/v1.0.0/collections",
    "https://api.stacspec.org/v1.0.0/ogcapi-features",
    "https://api.stacspec.org/v1.0.0/item-search",
    "https://api.stacspec.org/v1.0.0/item-search#fields",
    "https://api.stacspec.org/v1.0.0/item-search#sort",
    "https://api.stacspec.org/v1.0.0-rc.2/item-search#filter",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson",
    "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/filter",
    "http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2",
    "http://www.opengis.net/spec/cql2/1.0/conf/cql2-text",
    "http://www.opengis.net/spec/cql2/1.0/conf/cql2-json"
  ],
  "sdn:schemaVersion": "1.0.0",
  "links": [
    {
      "href": "https://api.satellitedata.net/v1",
      "rel": "self",
      "type": "application/json"
    },
    {
      "href": "https://api.satellitedata.net/v1",
      "rel": "root",
      "type": "application/json"
    },
    {
      "href": "https://api.satellitedata.net/v1/conformance",
      "rel": "conformance",
      "type": "application/json"
    },
    {
      "href": "https://api.satellitedata.net/v1/collections",
      "rel": "data",
      "type": "application/json"
    },
    {
      "href": "https://api.satellitedata.net/v1/search",
      "rel": "search",
      "type": "application/geo+json",
      "method": "GET"
    },
    {
      "href": "https://api.satellitedata.net/v1/search",
      "rel": "search",
      "type": "application/geo+json",
      "method": "POST"
    },
    {
      "href": "https://api.satellitedata.net/v1/openapi.json",
      "rel": "service-desc",
      "type": "application/vnd.oai.openapi+json;version=3.1"
    },
    {
      "href": "https://docs.satellitedata.net/",
      "rel": "service-doc",
      "type": "text/html"
    },
    {
      "href": "https://api.satellitedata.net/v1/schema",
      "rel": "describedby",
      "type": "application/json",
      "title": "Schema v1"
    }
  ]
}

Headers

X-Request-Id

string

Request id for support and logs.

Example

01JQ7Z3M8R5V2W6X9Y0A1B2C3D

ETag

string

Entity tag; includes the render version.

Example

"r3-9f2c1a"

Cache-Control

string

Caching policy for CloudFront and browsers.

Example

public, max-age=3600, s-maxage=2592000, stale-if-error=604800

429

A per-minute, concurrency, monthly or per-IP limit was hit. Retry-After says when to retry.

application/problem+json

RFC 9457 problem details. Every 4xx and 5xx response uses this shape with media type application/problem+json. The type URL opens a documentation page that explains the cause and the fix.

object

type

required

URL of the documentation page for this problem type, stable for the life of /v1.

string format: uri

title

required

Short summary of the problem type. It does not change between occurrences.

string

status

required

HTTP status code, repeated for clients that lose the status line.

integer

>= 400 <= 599

detail

required

Explanation specific to this occurrence, written for a developer.

string

instance

Path of the request that failed.

string

code

Machine-readable problem code; equals the last path segment of type.

string

/^[a-z0-9-]+$/

requestId

Request id, also sent in X-Request-Id. Quote it in support requests.

string

errors

Field-level validation failures, present on 400 and 422.

Array<object>

One field-level failure.

object

pointer

required

JSON Pointer (RFC 6901) into the request body, or the query parameter name.

string

detail

required

What is wrong with that member.

string

retryAfter

Seconds until the request can succeed; equals the Retry-After header.

integer

limits

The limit that was hit and the value requested, for example maxWidth and requestedWidth.

object

key

additional properties

number

unitsEstimated

Units the request would have cost, computed before execution.

number

error

OAuth 2.0 error code (RFC 6749 section 5.2). Present only on /oauth/token responses.

string

Allowed values: invalid_request invalid_client invalid_grant unauthorized_client unsupported_grant_type invalid_scope

error_description

OAuth 2.0 error description. Present only on /oauth/token responses.

string

message

Copy of detail for openEO clients, which read message. Present only on /v1/openeo routes.

string

key

additional properties

any

Example

{
  "type": "https://docs.satellitedata.net/problems/rate-limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "This key spent 300 of its 300 units in the current minute.",
  "instance": "/v1/process",
  "code": "rate-limited",
  "requestId": "01JQ7Z3M8R5V2W6X9Y0A1B2C3D",
  "retryAfter": 17,
  "limits": {
    "unitsPerMinute": 300,
    "unitsSpentThisMinute": 300
  }
}

Headers

X-Request-Id

string

Request id for support and logs.

Example

01JQ7Z3M8R5V2W6X9Y0A1B2C3D

Retry-After

integer

Seconds to wait before retrying.

Example

RateLimit

string

Remaining units and seconds to reset in the current window (IETF RateLimit header draft).

Example

"units";r=287;t=41

RateLimit-Policy

string

Quota policy of the caller (IETF RateLimit header draft).

Example

"units";q=300;w=60

500

An unexpected server error. No units are charged.

application/problem+json

RFC 9457 problem details. Every 4xx and 5xx response uses this shape with media type application/problem+json. The type URL opens a documentation page that explains the cause and the fix.

object

type

required

URL of the documentation page for this problem type, stable for the life of /v1.

string format: uri

title

required

Short summary of the problem type. It does not change between occurrences.

string

status

required

HTTP status code, repeated for clients that lose the status line.

integer

>= 400 <= 599

detail

required

Explanation specific to this occurrence, written for a developer.

string

instance

Path of the request that failed.

string

code

Machine-readable problem code; equals the last path segment of type.

string

/^[a-z0-9-]+$/

requestId

Request id, also sent in X-Request-Id. Quote it in support requests.

string

errors

Field-level validation failures, present on 400 and 422.

Array<object>

One field-level failure.

object

pointer

required

JSON Pointer (RFC 6901) into the request body, or the query parameter name.

string

detail

required

What is wrong with that member.

string

retryAfter

Seconds until the request can succeed; equals the Retry-After header.

integer

limits

The limit that was hit and the value requested, for example maxWidth and requestedWidth.

object

key

additional properties

number

unitsEstimated

Units the request would have cost, computed before execution.

number

error

OAuth 2.0 error code (RFC 6749 section 5.2). Present only on /oauth/token responses.

string

Allowed values: invalid_request invalid_client invalid_grant unauthorized_client unsupported_grant_type invalid_scope

error_description

OAuth 2.0 error description. Present only on /oauth/token responses.

string

message

Copy of detail for openEO clients, which read message. Present only on /v1/openeo routes.

string

key

additional properties

any

Example

{
  "type": "https://docs.satellitedata.net/problems/internal",
  "title": "Internal error",
  "status": 500,
  "detail": "The request failed on our side and was logged. No units were charged.",
  "instance": "/v1/process",
  "code": "internal",
  "requestId": "01JQ7Z3M8R5V2W6X9Y0A1B2C3D"
}

Headers

X-Request-Id

string

Request id for support and logs.

Example

01JQ7Z3M8R5V2W6X9Y0A1B2C3D