---
title: "Fetch the list of files for a snapshot"
method: GET
path: "/api/v1/datasets/{dataset}/snapshots/{snapshot}/files/{format}"
tags: ["/api/v1"]
---

# Fetch the list of files for a snapshot

`GET /api/v1/datasets/{dataset}/snapshots/{snapshot}/files/{format}`

## Request

- Base URL: `https://data.censys.io`
- URL: `https://data.censys.io/api/v1/datasets/{dataset}/snapshots/{snapshot}/files/{format}`
- Auth: HTTP bearer

Fetch the list of files for a snapshot.

## Path parameters

- `dataset` string, required
- `snapshot` string, required
- `format` string, required

## Query parameters

- `org` string, required
- `page_token` string

## Response `200`

A paginated list of the snapshots available in the dataset.

- object
  - `dataset` string: The dataset the files in this response belong to, mirrored from the request.
  - `file` File[], nullable: The files which are available.
    - `hashSha256` string: The SHA256 hash of the expected contents of the file.
    - `signature` string, byte: The signature of the expected file, which can be verified against Censys' public key.
    - `sizeBytes` integer: The size of the file, in bytes.
    - `url` string: The URL where the file can be retrieved via an HTTP GET request.
  - `nextPage` string: A token which can be used to get the next page of results.
  - `snapshot` string: The snapshot the files in this response belong to, mirrored from the request.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

---

[API](https://skmtc.dev/censys/apis/censys-data-snapshots.md) - [All operations](https://skmtc.dev/censys/apis/censys-data-snapshots/llms.txt) - [OpenAPI document](https://skmtc.dev/censys/apis/censys-data-snapshots/revisions/78be29892b18?raw)