---
title: "Dataset Files"
method: GET
path: "/datasets/{dataset}/files"
tags: ["data"]
---

# Dataset Files

`GET /datasets/{dataset}/files`

List contributing source files from recursive dbt source lineage.

## Path parameters

- `dataset` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- DatasetFiles
  - `dataset` string, required — Dataset identifier.
  - `files` DatasetFile[], required — Files contributing through the dataset's recursive dbt lineage.
    - `source_relation` string, required — Upstream dbt source relation containing rows from this file.
    - `file_id` string, required — Hermes file identifier.
    - `source_file` string, nullable — Source document name or relative path, when recorded.
    - `source_url` string, nullable — Canonical public source URL, when recorded.
  - `row_count` integer, required — Files returned in this page.
  - `limit` integer, required — Requested page size.
  - `offset` integer, required — Requested zero-based offset.
  - `has_more` boolean, required — Whether another page is available.
  - `next_offset` integer, nullable, required — Offset for the next page, when available.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/soriaanalytics/apis/soria-data-api.md) · [All operations](https://skmtc.dev/soriaanalytics/apis/soria-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/soriaanalytics/soria-data-api/revisions/e97615ca569b/schema)