List all datasets

GET/v2/datasets

Lists the datasets you can read, including datasets shared with your organization, sorted by name. Returns all matching datasets in one response without pagination.

Parameters

Property	Type	Location	Description
`exclude`	`string`	`query`	Exclude resolved label objects from each dataset response. The labelIds and labelNames fields are still returned.
`label`	`string[]`	`query`	Filter by label names in your organization. Repeat the parameter for multiple names, for example ?label=prod&label=team-a. Names match case-insensitively after whitespace normalization; duplicates count once. Commas are part of a name, not separators. Reading resources never creates missing labels.
`labelMatch`	`string`	`query`	How to combine label names: any (the default) requires at least one requested label on a resource; all requires every requested label on that same resource. For example, ?label=prod&label=team-a matches either label, while ?label=prod&label=team-a&labelMatch=all requires both. Unknown names have no matches with any and make all return no resources. Without label parameters, labelMatch has no effect.
`labelIds`	`string[]`	`query`	Return datasets assigned every specified label ID. When combined with label names, both filters must match; labelMatch applies only to names.

Request

curl -X GET 'https://api.axiom.co/v2/datasets' \
  -H 'Authorization: Bearer API_TOKEN'

Try itRun this request against your Axiom organization

Credentials stay in this browser tab and are only sent to Axiom when you run the request.

API token Requiredexclude querylabel querylabelMatch querylabelIds query

Response

200Datasets you can read.

application/json

400Bad Request

403Forbidden

Property	Type	Description
`canWrite`	`boolean`	Whether this dataset has write access
`created`	`string<date-time>`Required	The RFC3339-formatted time when the dataset was created.
`createdByAgent`	`boolean`	true when the MCP server created this dataset
`description`	`string`Required	Dataset description
`edgeDeployment`	`string`	Edge deployment of the dataset
`edgeDeploymentUrl`	`string`	URL of the edge deployment
`id`	`string`Required	Dataset ID
`kind`	`string`Required	The kind of the dataset
`labelIds`	`string[]`Required	IDs of labels assigned to this dataset.
`labelNames`	`string[]`Required	Names of assigned labels, including with exclude=labels; [] when unassigned.
`labels`	`object[]`	Resolved labels assigned to this dataset.
`color`	`object`Required
`name`	`string`Required
`type`	`string`Required
`description`	`string`
`id`	`string`Required
`name`	`string`Required
`mapFields`	`string[]`
`name`	`string`Required	Unique dataset name
`reclaimableFields`	`integer<int64>`	Number of unused fields a vacuum can reclaim, when the dataset is a vacuum candidate
`retentionDays`	`integer`	Number of days to retain data in the dataset
`sharedByOrg`	`string`	ID of the org that shared this resource, if it's shared
`updatedAt`	`string<date-time>`Required	The RFC3339-formatted time when the dataset was last updated.
`useRetentionPeriod`	`boolean`	Whether to use the retention period
`vacuumCandidate`	`boolean`	Whether the dataset has unused fields that a vacuum can reclaim
`who`	`string`Required	Name of the dataset creator