Dags

List DAGs

Required API-key scope: dags:read. Optional query filters: creator (hex wallet address that created the DAG), created_after / created_before (RFC3339, inclusive), finalized (true = executable, false = still being built), page_token, page_size.

get /dags

Authorizations

x-api-key string header required

Talus API Key in the form key_id.secret. The API also accepts Authorization: ApiKey <key_id.secret>, but the docs UI is configured to send x-api-key.

Query Parameters

creator string | null

Filter by the wallet address that created the DAG.

created_after string | null

Only include DAGs created at or after this RFC3339 timestamp.

created_before string | null

Only include DAGs created at or before this RFC3339 timestamp.

finalized boolean | null

Filter DAGs that have been finalized (true) — and are therefore executable — or are still being built (false).

page_token integer | null

Opaque token representing the page offset. Omit for the first page.

page_size integer | null

Maximum number of items to return. Defaults to 20.

200application/json

Paginated list of DAGs

items object[] required
created_at string required
creator string required
finalized_at string | null

When DAGFinalizedEvent sealed the DAG. Null means it is still being built and cannot be executed.

object_id string required
onchain_created_at string | null

Checkpoint timestamp of the on-chain creation event; null for rows projected before on-chain timestamps were indexed (until a backfill + replay fills them).

updated_at string required
metadata object required

Pagination metadata included in every listing response.

next_token integer | null

Token to pass as page_token to retrieve the next page. null means there are no more pages.

total_items integer<int64> required

Total number of items across all pages.

400

Invalid filter value

500

Internal server error