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

# Fetch the list of snapshots for a dataset

`GET /api/v1/datasets/{dataset}/snapshots`

## Request

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

Fetch the list of snapshots for a dataset.

## Path parameters

- `dataset` 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 snapshots in this response belong to, mirrored from the request.
  - `nextPage` string: A token which can be used to get the next page of results.
  - `snapshots` Snapshot[], nullable: The snapshots which are available.
    - `addedTime` string, date-time: The time the snapshot was generated.
    - `formats` Format[], nullable: A list of formats the snapshot is available for snapshot in.
      - `name` string: The name of the format.
    - `id` string: The ID of the snapshot, to be used in requests.

## 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)