---
title: "List details of periodic historical data snapshots (Beta)"
method: GET
path: "/orgs/{org_slug}/historical/snapshots"
tags: ["org-snapshots"]
---

# List details of periodic historical data snapshots (Beta)

`GET /orgs/{org_slug}/historical/snapshots`

This API endpoint is used to list the details of historical snapshots.
Snapshots of organization data are taken periodically, and each historical snapshot record contains high-level overview metrics about the data that was collected.
Other [Historical Data Endpoints](/reference/historical-data-endpoints) can be used to fetch the raw data associated with each snapshot.

Historical snapshots contain details and raw data for the following resources:

- Repositories
- Alerts
- Dependencies
- Artifacts
- Users
- Settings

Daily snapshot data is bucketed to the nearest day which is described in more detail at: [Historical Data Endpoints](/reference/historical-data-endpoints)

This endpoint consumes 10 units of your quota.

This endpoint requires the following org token scopes:
- historical:snapshots-list

## Path parameters

- `org_slug` string, required

## Query parameters

- `date` string
- `range` string
- `per_page` integer
- `startAfterCursor` string
- `filters.status` string
- `filters.requestId` string

## Response `200`

The historical snapshots.

- object
  - `meta` object, required
    - `organizationId` string, required
    - `queryStartTimestamp` number, required
    - `startDateInclusive` string, required
    - `endDateInclusive` string, required
    - `filters` object, required
      - `status` string[]
      - `requestId` string[]
  - `items` object[], required
    - `id` string, required
    - `requestId` string, required
    - `requestedBy` string, required
    - `requestedAt` string, required
    - `startedAt` string, required
    - `finishedAt` string, nullable, required
    - `durationMs` integer, required
    - `status` string, required
    - `numReposScanned` integer, required
    - `numSbomsScanned` integer, required
    - `numLowAlerts` integer, required
    - `numHighAlerts` integer, required
    - `numMediumAlerts` integer, required
    - `numCriticalAlerts` integer, required
    - `numIgnoredLowAlerts` integer, required
    - `numIgnoredHighAlerts` integer, required
    - `numIgnoredMediumAlerts` integer, required
    - `numIgnoredCriticalAlerts` integer, required
  - `endCursor` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Insufficient max_quota for API method
- `404` — Resource not found
- `429` — Insufficient quota for API route

---

[API](https://skmtc.dev/socket-dev/apis/socket.md) · [All operations](https://skmtc.dev/socket-dev/apis/socket/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/socket-dev/socket/revisions/bf994b75d33f/schema)