Changelog
Back to All
Added

v1.7.0 - Dataset Discovery & Download Endpoints

1 day ago by ReadMe GitHub Action

A new family of dataset endpoints is now available, giving API clients direct access to the Permutable data catalogue — including dataset listings, metadata, versioning, and download links.

Added

  • GET /datasets - List all available datasets. Supports filtering and pagination.

  • GET /datasets/pages - Return paginated dataset listings.

  • GET /datasets/categories - List the available dataset categories.

  • GET /datasets/latest - Return the most recently published datasets.

  • GET /datasets/latest/with-versions - Return the most recently published datasets with their associated version history.

  • GET /datasets/{dataset_id} - Retrieve metadata for a specific dataset by ID.

  • GET /datasets/{dataset_id}/versions - List all available versions for a dataset.

  • GET /datasets/{version_id}/download - Generate a download link for a specific dataset version.

  • GET /datasets/{dataset_id}/download/{document_type} - Generate a download link for a specific document type within a dataset.

All dataset endpoints require a valid API key and are subject to your usage plan limits.