List Dataset Attestations

Retrieve a paginated list of dataset attestations with optional filters.

Returns a paginated list of dataset attestations within the tenant scope. Use query parameters to filter by agent, dataset name, or apply pagination controls.

Authentication

X-API-Key · string · required

API key with datasets:read scope. Alternatively, pass a Bearer JWT token in the Authorization header.

X-Tenant-ID · string · required

Tenant identifier for multi-tenant isolation.

Query Parameters

agent_id · string

Filter datasets by the attesting agent identifier.

name · string

Filter datasets by exact name match.

limit · integer

Maximum number of results to return. Defaults to 20, maximum 100.

offset · integer

Number of results to skip for pagination. Defaults to 0.

Response

datasets · array

Array of dataset attestation objects. Each object contains id, agent_id, name, version, hash, record_count, schema_version, source_uri, status, receipt_id, metadata, and created_at.

total · integer

Total number of dataset attestations matching the filter criteria.