Programmatic access

Version v1
Base URL https://datasphere.astrodynamic.space

Authentication

Every request carries a bearer token in the standard Authorization header. There are two ways to get one, both from the dashboard under Account › Authentication.

Client credentials

For an integration that runs on its own. Create a client there, then exchange its id and secret for an access token at https://datasphere.astrodynamic.space/auth/oidc/token/ (OAuth 2.0 client credentials grant, client_secret_post). Ask for a new token when it expires.

curl -X POST https://datasphere.astrodynamic.space/auth/oidc/token/ \
     -d grant_type=client_credentials -d client_id=… -d client_secret=…

Temporary token

For a quick script or a trial. Generate it there and use it until it expires.

curl -H "Authorization: Bearer eyJ…" \
     https://datasphere.astrodynamic.space/stac/collections

A token acts as the account that created it, and reaches only what that account may see. A browser session cookie is not accepted.

Common shapes

  • Encoding. All requests and responses are UTF-8 JSON unless explicitly noted.
  • Dates. ISO 8601 in UTC (2026-04-26T12:00:00Z).
  • Geometries. GeoJSON. A bbox follows STAC ordering: [west, south, east, north], that is, lower-left longitude, lower-left latitude, upper-right longitude, upper-right latitude, in that order. Longitude comes first in each pair, not latitude.
  • Pagination. /api/items/ and /api/grants/ return 50 results a page; limit sets that from 1 to 100. A page of grants may come back short: follow next until it is absent. A search at /ds/search continues with ?search=<id>&page=N. Each response carries links with next and prev relations where they exist, so follow those rather than building the address yourself.
  • Retries. There is no idempotency header. Placing an order is safe to retry: send the same order_ids again and the existing order is returned with no second charge.

Search, then order

POST /ds/search token

A STAC API search across every supplier, the same search the form on /search runs. Give a bbox or an intersects polygon. Suppliers answer as they finish, so the reply's ds:search object says whether the search is complete; read the same page again until it is. Each priced feature carries the ad:order_id you order it by.

POST /ds/search
Content-Type: application/json

{
  "bbox":        [-5.5, 49.0, 1.7, 55.7],
  "datetime":    "2025-01-01T00:00:00Z/2025-06-30T23:59:59Z",
  "collections": ["sentinel-2-l2a"]
}
POST /order token

Orders the features named by order_ids from your own searches and charges your saved card. Every request, a retry included, carries "accept_terms": true and "waive_withdrawal": true. A 202 means the order was placed but the payment outcome is not yet known: poll it rather than placing it again.

GET /api/orders/<id>/ token

One of your orders and its status. /api/orders/ lists them all.

STAC API

Browse, search and download what you own with any STAC tool, at https://datasphere.astrodynamic.space/stac. The landing page and the conformance list need no token; every other call takes the bearer token above.

GET /stac

STAC landing page. The front door of the STAC API. It lists what the API offers and links to every other page.

curl https://datasphere.astrodynamic.space/stac
200 , application/json
A STAC Catalog: the API's id, description, the standards it follows and links to its other pages.
{
  "type": "Catalog",
  "stac_version": "1.0.0",
  "id": "…",
  "description": "…",
  "conformsTo": [ "https://api.stacspec.org/v1.0.0/core", … ],
  "links": [
    { "rel": "root",       "href": "…" },
    { "rel": "conformance","href": "…" },
    { "rel": "data",       "href": "…/collections" },
    { "rel": "search",     "href": "…/search", "method": "GET" }
  ]
}
GET /stac/conformance

STAC conformance. Lists the parts of the STAC and OGC standards this API follows, for tools that need to know.

curl https://datasphere.astrodynamic.space/stac/conformance
200 , application/json
A conformsTo list of standard URIs.
{
  "conformsTo": [
    "https://api.stacspec.org/v1.0.0/core",
    "https://api.stacspec.org/v1.0.0/item-search",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core"
  ]
}
GET /stac/collections token

List collections. Lists the collections you can read. A collection is a group of related products, for example everything from one satellite.

bbox , query, string
Only results touching this box, as four numbers west,south,east,north with longitude first. Not with intersects.
datetime , query, string
A date and time in UTC, or an interval such as 2025-01-01T00:00:00Z/2025-06-30T23:59:59Z. Either end may be .. to leave it open.
limit , query, integer
How many results to return in a page. Default 10, at most 10000.
query , query, string
Filter on properties, as URL-encoded JSON, for example {"eo:cloud_cover": {"lt": 20}}.
sortby , query, string
Property names separated by commas, each with + for ascending or - for descending, for example -datetime.
fields , query, string
Properties to return or leave out, separated by commas, for example id,properties.datetime,-geometry.
filter , query, string
A CQL2 filter expression, URL-encoded.
filter-lang , query, string
How filter is written, cql2-text (default) or cql2-json.
filter-crs , query, string
The coordinate reference system of any place named in filter. Default is WGS 84 (CRS84).
q , query, string
Words to look for in the collections' titles and descriptions.
offset , query, integer
How many collections to skip, for paging.
curl -H "Authorization: Bearer eyJ…" \
     "https://datasphere.astrodynamic.space/stac/collections?limit=10"
200 , application/json
A list of collections, with links and the counts numberMatched and numberReturned.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
409
Your account has no root catalogue yet. Finish account setup first.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
{
  "collections": [ { "type": "Collection", "id": "sentinel-2-l2a", … } ],
  "links": [ { "rel": "self", "href": "…" } ],
  "numberMatched": 1,
  "numberReturned": 1
}
GET /stac/collections/<collection_id> token

See one collection. Shows one collection: its name, the area and period it covers, and its licence.

collection_id , path, string
The id of the collection, as listed by /stac/collections.
curl -H "Authorization: Bearer eyJ…" \
     https://datasphere.astrodynamic.space/stac/collections/sentinel-2-l2a
200 , application/json
A STAC Collection.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
404
The collection does not exist or you may not see it. The answer is the same for both: { "code": "NotFoundError", "description": "Collection x does not exist." }.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
{
  "type": "Collection",
  "stac_version": "1.0.0",
  "id": "sentinel-2-l2a",
  "title": "Sentinel-2 Level-2A",
  "description": "Surface reflectance from Sentinel-2.",
  "license": "proprietary",
  "extent": {
    "spatial":  { "bbox": [[-10.0, 49.0, 2.0, 61.0]] },
    "temporal": { "interval": [["2025-01-01T00:00:00Z", null]] }
  },
  "links": [ { "rel": "self", "href": "…", "type": "application/json" } ]
}
GET /stac/collections/<collection_id>/items token

List the products in a collection. Lists the products in one collection that you may read, a page at a time.

collection_id , path, string
The id of the collection, as listed by /stac/collections.
limit , query, integer
How many results to return in a page. Default 10, at most 10000.
bbox , query, string
Only results touching this box, as four numbers west,south,east,north with longitude first. Not with intersects.
datetime , query, string
A date and time in UTC, or an interval such as 2025-01-01T00:00:00Z/2025-06-30T23:59:59Z. Either end may be .. to leave it open.
query , query, string
Filter on properties, as URL-encoded JSON, for example {"eo:cloud_cover": {"lt": 20}}.
sortby , query, string
Property names separated by commas, each with + for ascending or - for descending, for example -datetime.
fields , query, string
Properties to return or leave out, separated by commas, for example id,properties.datetime,-geometry.
filter , query, string
A CQL2 filter expression, URL-encoded.
filter-lang , query, string
How filter is written, cql2-text (default) or cql2-json.
filter-crs , query, string
The coordinate reference system of any place named in filter. Default is WGS 84 (CRS84).
token , query, string
A paging token. Do not make one up: follow the next link in the response.
curl -H "Authorization: Bearer eyJ…" \
     "https://datasphere.astrodynamic.space/stac/collections/sentinel-2-l2a/items?limit=10"
200 , application/geo+json
A GeoJSON FeatureCollection of STAC items. links carries next and prev where they exist, and numberMatched is left out when some results were withheld from you.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
404
The collection does not exist or you may not see it. The answer is the same for both: { "code": "NotFoundError", "description": "Collection x does not exist." }.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
{
  "type": "FeatureCollection",
  "features": [ { "type": "Feature", "id": "S2B_30UXC_20250612", … } ],
  "links": [ { "rel": "next", "href": "…", "method": "GET" } ],
  "numberMatched": 42,
  "numberReturned": 10
}
GET /stac/collections/<collection_id>/items/<item_id> token

See one product. Shows one product, with its location, its date and the files you can download for it.

collection_id , path, string
The id of the collection, as listed by /stac/collections.
item_id , path, string
The id of the product (a STAC item) in that collection.
curl -H "Authorization: Bearer eyJ…" \
     https://datasphere.astrodynamic.space/stac/collections/sentinel-2-l2a/items/S2B_30UXC_20250612
200 , application/geo+json
A STAC Item. Each entry in assets is a file you may download.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
404
The product does not exist in that collection or you do not own it. The answer is the same for both.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
{
  "type": "Feature",
  "stac_version": "1.0.0",
  "id": "S2B_30UXC_20250612",
  "collection": "sentinel-2-l2a",
  "geometry": { "type": "Polygon", "coordinates": [ … ] },
  "bbox": [-1.2, 51.0, 0.4, 52.1],
  "properties": { "datetime": "2025-06-12T11:05:21Z", "eo:cloud_cover": 8.2 },
  "assets": { "visual": { "href": "…", "type": "image/tiff; application=geotiff" } },
  "links": [ { "rel": "self", "href": "…" }, { "rel": "collection", "href": "…" } ]
}
GET /stac/search token

Search your products (query string). Search the products you own by area, date and properties such as cloud cover. This searches what you already hold. To find imagery to buy, use the search in the Search API.

collections , query, string
Collection ids separated by commas. Only products from these collections.
ids , query, string
Product ids separated by commas. Only these products.
bbox , query, string
Only results touching this box, as four numbers west,south,east,north with longitude first. Not with intersects.
intersects , query, string
A GeoJSON geometry, URL-encoded. Only results touching it. Not with bbox.
datetime , query, string
A date and time in UTC, or an interval such as 2025-01-01T00:00:00Z/2025-06-30T23:59:59Z. Either end may be .. to leave it open.
limit , query, integer
How many results to return in a page. Default 10, at most 10000.
query , query, string
Filter on properties, as URL-encoded JSON, for example {"eo:cloud_cover": {"lt": 20}}.
sortby , query, string
Property names separated by commas, each with + for ascending or - for descending, for example -datetime.
fields , query, string
Properties to return or leave out, separated by commas, for example id,properties.datetime,-geometry.
filter , query, string
A CQL2 filter expression, URL-encoded.
filter-lang , query, string
How filter is written, cql2-text (default) or cql2-json.
filter-crs , query, string
The coordinate reference system of any place named in filter. Default is WGS 84 (CRS84).
token , query, string
A paging token. Do not make one up: follow the next link in the response.
curl -H "Authorization: Bearer eyJ…" \
     "https://datasphere.astrodynamic.space/stac/search?collections=sentinel-2-l2a&bbox=-5.5,49.0,1.7,55.7&limit=10"
200 , application/geo+json
A GeoJSON FeatureCollection of the matching products you own, with links and the counts numberMatched and numberReturned.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
409
Your account has no root catalogue yet. Finish account setup first.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
{
  "type": "FeatureCollection",
  "features": [ { "type": "Feature", "id": "S2B_30UXC_20250612", … } ],
  "links": [ { "rel": "next", "href": "…", "method": "GET" } ],
  "numberMatched": 42,
  "numberReturned": 10
}
POST /stac/search token

Search your products (JSON body). The same search as the query-string form, with the filters sent as a JSON body.

collections , body, array of strings
Only products from these collections.
ids , body, array of strings
Only these products.
bbox , body, array of numbers
Four numbers, [west, south, east, north], longitude first. Not with intersects.
intersects , body, GeoJSON geometry
Only results touching this geometry. Not with bbox.
datetime , body, string
A date and time in UTC, or an interval such as 2025-01-01T00:00:00Z/2025-06-30T23:59:59Z. Either end may be ...
limit , body, integer
How many results to return in a page. Default 10, at most 10000.
query , body, object
Filter on properties, for example {"eo:cloud_cover": {"lt": 20}}.
sortby , body, array of objects
Each { "field": "datetime", "direction": "desc" }, with asc or desc.
fields , body, object
{ "include": [...], "exclude": [...] }: properties to return or leave out.
filter , body, object
A CQL2 filter written as JSON.
filter-lang , body, string
Always cql2-json for a body (default).
filter-crs , body, string
The coordinate reference system of any place named in filter. Default is WGS 84 (CRS84).
token , body, string
A paging token. Take it from the next link of the previous page.
curl -X POST https://datasphere.astrodynamic.space/stac/search \
     -H "Authorization: Bearer eyJ…" -H "Content-Type: application/json" \
     -d '{"collections": ["sentinel-2-l2a"], "bbox": [-5.5, 49.0, 1.7, 55.7], "limit": 10}'
200 , application/geo+json
A GeoJSON FeatureCollection of the matching products you own, with links and the counts numberMatched and numberReturned.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
409
Your account has no root catalogue yet. Finish account setup first.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
{
  "type": "FeatureCollection",
  "features": [ { "type": "Feature", "id": "S2B_30UXC_20250612", … } ],
  "links": [ { "rel": "next", "href": "…", "method": "GET" } ],
  "numberMatched": 42,
  "numberReturned": 10
}
GET /stac/queryables token

List the filters you can use. Lists the properties a search over all collections may filter on.

curl -H "Authorization: Bearer eyJ…" \
     https://datasphere.astrodynamic.space/stac/queryables
200 , application/schema+json
A JSON Schema whose properties are the names you may filter on.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
{
  "$schema": "https://json-schema.org/draft/2019-09/schema",
  "$id": "…/queryables",
  "type": "object",
  "title": "Queryables",
  "properties": { "datetime": { "type": "string" }, "eo:cloud_cover": { "type": "number" } }
}
GET /stac/collections/<collection_id>/queryables token

List the filters for one collection. Lists the properties a search inside this collection may filter on.

collection_id , path, string
The id of the collection, as listed by /stac/collections.
curl -H "Authorization: Bearer eyJ…" \
     https://datasphere.astrodynamic.space/stac/collections/sentinel-2-l2a/queryables
200 , application/schema+json
A JSON Schema whose properties are the names you may filter on in this collection.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
404
The collection does not exist or you may not see it. The answer is the same for both: { "code": "NotFoundError", "description": "Collection x does not exist." }.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
{
  "$schema": "https://json-schema.org/draft/2019-09/schema",
  "$id": "…/queryables",
  "type": "object",
  "title": "Queryables",
  "properties": { "datetime": { "type": "string" }, "eo:cloud_cover": { "type": "number" } }
}
GET /stac/collections/<collection_id>/items/<item_id>/assets/<asset_key> token

Download one file. Downloads one file of a product you own. Send the same token you used to find it. Large files can be fetched in parts with a Range header, so an interrupted download can carry on.

collection_id , path, string
The id of the collection, as listed by /stac/collections.
item_id , path, string
The id of the product (a STAC item) in that collection.
asset_key , path, string
The key of the file, as named in the product's assets.
Range , header, string
Optional. A byte range such as bytes=0-1048575, to fetch part of a file.
curl -H "Authorization: Bearer eyJ…" -o scene.tif \
     https://datasphere.astrodynamic.space/stac/collections/sentinel-2-l2a/items/S2B_30UXC_20250612/assets/visual
200, 206 , the file's own type
The file itself, as a download. 206 when a Range was sent and met.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
404
The product does not exist in that collection or you do not own it. The answer is the same for both.
416
The range asked for cannot be met.
422 , application/json
A path value is malformed.
502
The file could not be fetched from where it is held. Try again later.
HTTP/1.1 200 OK
Content-Type: image/tiff; application=geotiff
Content-Disposition: attachment; filename="…"
Accept-Ranges: bytes

<file bytes>
GET /stac/collections/<collection_id>/items/<item_id>/assets/zip token

Download every file of a product as one zip. Downloads all the files of one product you own, packed into a single zip file.

collection_id , path, string
The id of the collection, as listed by /stac/collections.
item_id , path, string
The id of the product (a STAC item) in that collection.
curl -H "Authorization: Bearer eyJ…" -o product.zip \
     https://datasphere.astrodynamic.space/stac/collections/sentinel-2-l2a/items/S2B_30UXC_20250612/assets/zip
200 , application/zip
A zip with one entry for each file, named <item_id>/<asset_key>. A file that cannot be delivered at the moment is left out.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
404
You do not own the product, or it has no file to deliver.
422 , application/json
A path value is malformed.
413
The product has more files than one zip may hold.
HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename="…"

<zip bytes>
POST /stac/collections/<collection_id>/items/<item_id>/assets/zip token

Download chosen files of a product as one zip. Downloads only the files you name in the request body, packed into a single zip file.

collection_id , path, string
The id of the collection, as listed by /stac/collections.
item_id , path, string
The id of the product (a STAC item) in that collection.
assets , body, array of strings
Required. The keys of the files to include, 1 to 1000. Keys the product does not have are ignored.
curl -X POST -H "Authorization: Bearer eyJ…" -H "Content-Type: application/json" \
     -d '{"assets": ["visual", "B04"]}' -o product.zip \
     https://datasphere.astrodynamic.space/stac/collections/sentinel-2-l2a/items/S2B_30UXC_20250612/assets/zip
200 , application/zip
A zip with one entry for each file named that the product has, named <item_id>/<asset_key>.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
404
You do not own the product, or it has none of the files named.
413
More files named than one zip may hold.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename="…"

<zip bytes>
GET /stac/collections/<collection_id>/assets/zip token

Download a whole collection as one zip. Downloads every file of every product you own in one collection, packed into a single zip file. Add asset=<key> to take only that file from each product. A collection too large for one zip is refused, and you are asked to name the products with the POST form.

collection_id , path, string
The id of the collection, as listed by /stac/collections.
asset , query, string
One file key, 1 to 150 characters. Take only that file from each product.
curl -H "Authorization: Bearer eyJ…" -o collection.zip \
     "https://datasphere.astrodynamic.space/stac/collections/sentinel-2-l2a/assets/zip?asset=visual"
200 , application/zip
A zip with one entry for each file, named <item_id>/<asset_key>.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
404
You own no product in the collection, or none has that file.
413
You own more products than one request may carry. Name them with the POST form.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename="…"

<zip bytes>
POST /stac/collections/<collection_id>/assets/zip token

Download chosen products of a collection as one zip. Downloads the products you name in the request body, and if you wish only certain files of each, packed into a single zip file.

collection_id , path, string
The id of the collection, as listed by /stac/collections.
items , body, array of strings
Required. The ids of the products to include, 1 to 10000. Products you do not own, or that are not in this collection, are left out.
assets , body, array of strings
Optional. The keys of the files to take from each product, 1 to 1000. All of them when left out.
curl -X POST -H "Authorization: Bearer eyJ…" -H "Content-Type: application/json" \
     -d '{"items": ["S2B_30UXC_20250612"], "assets": ["visual"]}' -o collection.zip \
     https://datasphere.astrodynamic.space/stac/collections/sentinel-2-l2a/assets/zip
200 , application/zip
A zip with one entry for each file, named <item_id>/<asset_key>.
401, 429, 503
No token or one that is not accepted (401, with WWW-Authenticate: Bearer); too many requests in the minute (429, with Retry-After); the access check could not be made (503). Each body is { "detail": "…" }.
404
Nothing remains once the products you do not own are left out.
413
More products named than one request may carry.
422 , application/json
A parameter is malformed. detail lists each one at fault, as { "detail": [ { "loc": ["query", "limit"], "msg": "…", "type": "…" } ] }.
HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename="…"

<zip bytes>

Error responses

Errors carry a detail message explaining what went wrong:

{ "detail": "order_ids: must be a non-empty list of order id strings." }
HTTPWhen
400Validation error in body or query.
401Missing or invalid credentials.
402An order could not be paid for: no saved payment method, a spending limit reached, or a charge refused. Place it again once that is resolved.
403Authenticated, but refused: the email address is not verified, the terms are not accepted, verification or screening is not clear, or the token was not created behind a second factor.
404Resource (item, order, search) does not exist, is not yours, or has expired.
409An order names items already part of a different order, or one of its providers cannot yet be paid. Nothing is charged.
429Rate limited; respect Retry-After header.
5xxPlatform error; retry with exponential backoff.

Limits

The ceiling on these endpoints is the one your plan carries, counted per minute per account, not a single figure for everybody. See the plans page for the allowance on each plan.

Once it is spent the API answers 429 with a Retry-After header giving the seconds to wait. The window is a fixed minute rather than a sliding one, so Retry-After is the whole minute rather than a tighter estimate.

Cookbook

Python

import os, requests
HEADERS = {"Authorization": f"Bearer {os.environ['DS_TOKEN']}"}
r = requests.get(
    "https://datasphere.astrodynamic.space/api/items/",
    headers=HEADERS,
    params={"from": "2025-01-01", "to": "2025-06-30"},
    timeout=30,
)
r.raise_for_status()
for feat in r.json()["features"]:
    print(feat["id"], feat["properties"]["datetime"])

JavaScript

const r = await fetch("https://datasphere.astrodynamic.space/api/items/?from=2025-01-01", {
  headers: { "Authorization": `Bearer ${token}` },
});
const { features } = await r.json();