Locating Downloadable Data (STAC API)

If your Discovery Platform account is configured to allow data downloads, your download entitlements are based on areas of interest and/or specific scene IDs. If you already know what your entitlement areas of interest (Download Access Areas) or scene IDs are, you can use that information to query data via the STAC API.

For help locating downloadable data in the Discovery Portal, check out this separate article.

If you don't know what your download entitlements are, you can look them up using Hydrosat's Accounts API.

If you would like to get access to downloadable data, contact our sales team.

Using Accounts API

Accounts API uses the same bearer token Authentication and API credentials as the STAC API.

Use the following endpoint to GET the active access policy for your account, which includes information about your download entitlements.

https://accounts.hydrosat.com/v2/me/access-policies

The polygons for area of interest-based download entitlements are listed within product_entitlements and scene ID-based entitlements are listed within scene_entitlements. The product_entitlements and scene_entitlements also include information about which STAC collections are you entitled to download from.

meResponse = requests.request("GET",'https://accounts.hydrosat.com/v2/me/access-policies', headers=myheaders)
meContent = meResponse.json()
access_policy = meContent.get("access_policies", [])[0]
scene_entitlements = access_policy.get("scene_entitlements", [])
product_entitlements = access_policy.get("product_entitlements", [])

Response Examples

A product_entitlements example with a single polygon areas_of_interest is shown below.

[
   {
      "id":"d1ab374b-7623-416d-9dc9-b62df7866625",
      "access_policy_id":"98ab1aa0-02a2-4a75-b5bf-19e95f5eb08e",
      "product_name":"archive",
      "configuration":{
         "product_name":"archive",
         "collections":[
            "vz-liri-l1a",
            "vz-viri-l1a",
            "vz-l1b",
            "vz-l2"
         ],
         "restrict_search":false,
         "restrict_items":true,
         "restrict_properties":true
      },
      "areas_of_interest":[
         {
            "id":"448e8a88-0c56-4406-b9ba-a64b2c946584",
            "product_entitlement_id":"d1ab374b-7623-416d-9dc9-b62df7866625",
            "name":"Lake",
            "geometry":{
               "type":"Polygon",
               "coordinates":[
                  [
                     [
                        -94.0733085212435,
                        31.98981826138629
                     ],
                     [
                        -93.82521380712805,
                        31.113313105933432
                     ],
                     [
                        -93.41658721917305,
                        31.01958485756203
                     ],
                     [
                        -93.38010270239135,
                        31.275556307422413
                     ],
                     [
                        -93.5260407695181,
                        31.704771952854895
                     ],
                     [
                        -93.82521380712805,
                        31.97125515504588
                     ],
                     [
                        -94.0733085212435,
                        31.98981826138629
                     ]
                  ]
               ]
            },
            "created":"2026-07-10T23:12:25.815575Z",
            "updated":"2026-07-10T23:12:25.815575Z"
         }
      ],
      "created":"2026-07-10T23:12:25.587717Z",
      "updated":"2026-07-10T23:12:25.587717Z"
   }
]

A scene_entitlements example containing 2 scene_ids is shown below.

[
   {
      "id":"5d756296-38d0-4c61-a256-1cfc4eeee411",
      "access_policy_id":"ffdf58c5-c527-4c32-98cf-933a2114f0c5",
      "collections":[
         "vz-liri-l1a",
         "vz-viri-l1a",
         "vz-l1b",
         "vz-l2"
      ],
      "scene_id":"VZ01_20260306_050940",
      "created":"2026-07-10T21:54:04.501632Z",
      "updated":"2026-07-10T21:54:04.501632Z"
   },
   {
      "id":"e9377d49-6342-4530-ad87-325cd3a04989",
      "access_policy_id":"ffdf58c5-c527-4c32-98cf-933a2114f0c5",
      "collections":[
         "vz-liri-l1a",
         "vz-viri-l1a",
         "vz-l1b",
         "vz-l2"
      ],
      "scene_id":"VZ02_20260514_073333",
      "created":"2026-07-10T21:54:04.391214Z",
      "updated":"2026-07-10T21:54:04.391214Z"
   }
]