Skip to content
GuidesBlogPlaygroundDashboard

Datasets

List all datasets
datasets.list() -> DatasetList
GET/api/v1/datasets
Create a new dataset (admin only)
datasets.create(DatasetCreateParams**kwargs) -> Dataset
POST/api/v1/datasets
Get dataset by ID
datasets.retrieve(strid) -> Dataset
GET/api/v1/datasets/{id}
Delete a dataset
datasets.delete(strid)
DELETE/api/v1/datasets/{id}
Query features in a dataset
datasets.features(strid, DatasetFeaturesParams**kwargs) -> FeatureCollection
GET/api/v1/datasets/{id}/features
ModelsExpand Collapse
class Dataset:

Metadata for a custom dataset. Datasets contain user-uploaded geospatial features separate from the OSM data.

id: str

Dataset UUID

formatuuid
inserted_at: datetime

Creation timestamp (UTC)

formatdate-time
name: str

Human-readable dataset name

slug: str

URL-friendly identifier

updated_at: datetime

Last update timestamp (UTC)

formatdate-time
attribution: Optional[str]

Required attribution text

description: Optional[str]

Dataset description

license: Optional[str]

License identifier (e.g. CC-BY-4.0)

source_url: Optional[str]

URL of the original data source

formaturi
class DatasetList:

List of all available datasets.

datasets: List[Dataset]

Array of dataset metadata objects

id: str

Dataset UUID

formatuuid
inserted_at: datetime

Creation timestamp (UTC)

formatdate-time
name: str

Human-readable dataset name

slug: str

URL-friendly identifier

updated_at: datetime

Last update timestamp (UTC)

formatdate-time
attribution: Optional[str]

Required attribution text

description: Optional[str]

Dataset description

license: Optional[str]

License identifier (e.g. CC-BY-4.0)

source_url: Optional[str]

URL of the original data source

formaturi