Get list of files for a dataset

GET 
/datasets/:id/files

Returns a paginated list of dataset file metadata for the dataset. Pagination contract (no nextToken): - limit: page size; default 100; max 500 (IPV-1050 if exceeded). - offset: 1-based item start index (not page number). The service subtracts 1 to get the 0-based start. Omit for the first page (starts at 0). For the next page use offset = previous_offset + limit (e.g. limit=100 → pages at offset 1, 101, 201, ...).

• Response count: number of items in this page's files array. - Response total_count: total matching files (before page slice), except when storage is set — then count/total_count reflect the filtered current page only.
• Response next_available: "yes" if more items remain after this page (offset + limit < total_count in 0-based terms), else "no". Stop paging when next_available is "no" or count is 0.
• from_time and to_time must be used together (LastModified range). - sortby only supports LastModified (GE-1047 otherwise); sortorder defaults to desc.
• Invalid status → DS-1025. Read-only callers on TBAC datasets only see files matching their tags.

Request

Responses

200

Paginated files list. Continue while next_available is "yes" by advancing offset by limit; stop when next_available is "no".

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation failure. Codes include IPV-1050 (limit > 500), GE-1047 (invalid sortby), DS-1025 (invalid status).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend/generic failure.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers