API reference
Open console 〉

Get specific STAC items

post
https://api.up42.com/v2/assets/stac/search

Make a detailed search request to find specific STAC items in your storage.

Body Params
collections
array of strings

Search for STAC items in the specified STAC collections.

Collections
ids
array of strings

Search for specific STAC items by their IDs.

IDs
string

Search for data that has a temporal property that intersects the datetime value in the RFC 3339 format. You can search for a specific date and time, or for a closed or an open date interval. Express open intervals using double-dots.

  • An example of a timestamp: "2025-02-12T23:20:50Z".
  • An example of a closed interval: "2025-02-12T00:00:00Z/2018-03-18T12:31:12Z".
  • Examples of open intervals: "2025-02-12T00:00:00Z/.." or "../2025-03-18T12:31:12Z".'
sortby
array of objects

A results sorting method that arranges elements in ascending or descending order based on a chosen field.

Response sorting
integer
1 to 10000
Defaults to 10

The maximum number of data items on a results page.

integer

The number of the page to return. To get the first page, set the parameter to 0.

filter
object

A CQL2 filter that consists of arguments (filter.args) and operators (filter.op).

string
enum
Defaults to cql2-json

The CQL filter that encodes the value used in filter. The only supported value is cql2-json.

Allowed:
bbox
array of doubles
length between 4 and 4

Search for data that intersects a bounding box in the [min longitude, min latitude, max longitude, max latitude] format. Use only if intersects isn't specified.

Intersecting bbox
intersects

Search for data that intersects the provided geometry. Use only if bbox isn't specified.

Responses

500

Server error. Please contact support

Updated 7 months ago

Language
Credentials
Bearer
JWT
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 7 months ago