Programmatic access
Version v1https://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;limitsets that from 1 to 100. A page of grants may come back short: follownextuntil it is absent. A search at/ds/searchcontinues with?search=<id>&page=N. Each response carrieslinkswithnextandprevrelations 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_idsagain and the existing order is returned with no second charge.
Search, then order
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"]
}
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.
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.
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" }
]
}
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
conformsTolist 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"
]
}
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,northwith longitude first. Not withintersects. - 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
filteris written,cql2-text(default) orcql2-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
linksand the countsnumberMatchedandnumberReturned. - 401, 429, 503
- No token or one that is not accepted (
401, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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
}
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, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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" } ]
}
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,northwith longitude first. Not withintersects. - 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
filteris written,cql2-text(default) orcql2-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
nextlink 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.
linkscarriesnextandprevwhere they exist, andnumberMatchedis left out when some results were withheld from you. - 401, 429, 503
- No token or one that is not accepted (
401, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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
}
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
assetsis a file you may download. - 401, 429, 503
- No token or one that is not accepted (
401, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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": "…" } ]
}
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,northwith longitude first. Not withintersects. - 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
filteris written,cql2-text(default) orcql2-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
nextlink 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
linksand the countsnumberMatchedandnumberReturned. - 401, 429, 503
- No token or one that is not accepted (
401, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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
}
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 withintersects. - 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" }, withascordesc. - 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-jsonfor 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
nextlink 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
linksand the countsnumberMatchedandnumberReturned. - 401, 429, 503
- No token or one that is not accepted (
401, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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
}
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
propertiesare the names you may filter on. - 401, 429, 503
- No token or one that is not accepted (
401, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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" } }
}
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
propertiesare the names you may filter on in this collection. - 401, 429, 503
- No token or one that is not accepted (
401, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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" } }
}
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.
206when aRangewas sent and met. - 401, 429, 503
- No token or one that is not accepted (
401, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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>
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, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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>
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, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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>
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, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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>
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, withWWW-Authenticate: Bearer); too many requests in the minute (429, withRetry-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.
detaillists 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." }
| HTTP | When |
|---|---|
| 400 | Validation error in body or query. |
| 401 | Missing or invalid credentials. |
| 402 | An 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. |
| 403 | Authenticated, 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. |
| 404 | Resource (item, order, search) does not exist, is not yours, or has expired. |
| 409 | An order names items already part of a different order, or one of its providers cannot yet be paid. Nothing is charged. |
| 429 | Rate limited; respect Retry-After header. |
| 5xx | Platform 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();