Changelog

• Added get_usage(): your organisation's subscription and AOI counts and subscribed hectares, all-time and for the current calendar month, alongside the monthly subscription limit (and, for unverified organisations, the account caps). Requires the corresponding API release.

• Improved load_dataframe() performance for self-hosted datasets: the parquet footer is now read once per file instead of twice (up to ~3s faster per call on wide datasets).
• Added optional columns parameter to load_dataframe() to load a subset of columns (self-hosted datasets only); geometry is always included.
• load_xarray() now applies scale_factor/add_offset for bands that declare them in the dataset file schema: values are returned as physical float32 with NaN nodata, and the packing metadata moves to each variable's .encoding. Pass mask_and_scale=False to get raw packed values with the true scale_factor/add_offset as attributes instead. Bands without a declared scale/offset are unaffected.
• Fixed load_xarray() stamping the first file's scale_factor/add_offset attributes onto every variable; variables without a declared scale/offset no longer carry these attributes.
• Added geometry_type and location_count to the AOI model (returned by the API since 2026-08-20).

• Improves load_dataframe() compatibility with more vector dataset types across different coordinate reference systems.

• Changed load_dataframe() to return GeoDataframe format.
• Upgraded Python required version to 3.11.

• Added get_dataset().
• Added all details to Dataset.
• Improved error handling.
• Made external_ref nullable for Subscription and AOI.
• Renamed get_organisation_settings() to get_settings().
• Renamed update_organisation_settings() to update_settings().

• Changed load_dataframe() to retry when failing to load files from bucket.

Webhook improvements

• Added list_webhooks().
• Added get_webhook().
• Renamed webhook_configure() to create_webhook().
• Changed delete_webhook() to receive an id param.

Archive/restore AOI

• Added archive_aoi().
• Added restore_aoi().
• Changed list_aois() to accept an optional archived param.

Archive/restore subscription

• Added archive_subscription().
• Added restore_subscription() within the grace period.
• Changed list_subscriptions() to accept an optional archived param.

• Added configure_webhook().
• Added delete_webhook().
• Added HTTPError and SDKError.
• Improved error handling.

• Added list_datasets().

• Changed load_dataframe() to reset dataframe index after concatenation.

• Updated error handling to handle HTTP 403 Forbidden errors.

• Renamed AOIRecord to AOI.

• Changed load_dataframe() to return empty dataframe when no data is available.

• Updated dependencies.

• First release.