Locating Downloadable Data | Hydrosat Docs

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"\
   }\
]