---
updatedAt: 2025-09-10T01:20:50.000Z
agentTools:
  projectIndex: https://support.speedcurve.com/llms.txt
---

# Get all snapshots

Get list of snapshots.

**Snapshots** represent sets of [on-demand tests](https://support.speedcurve.com/docs/ondemand-site-testing) of your website or custom URLs. It's the way how the tests, submitted simultaneously, are grouped.

This endpoint allows you to get the list and basic properties for your snapshots, and ability to filter them by date range, site ID and/or deploy ID.

This endpoint returns all snapshots triggered from different sources: this API, [v1 Deploy API](https://support.speedcurve.com/reference/get-all-deploys), the [SpeedCurve UI](https://support.speedcurve.com/docs/ondemand-site-testing#how-to-test-your-site-on-demand-using-test-now), [CLI](https://github.com/SpeedCurve-Metrics/speedcurve-cli), [GitHub Integration](https://support.speedcurve.com/docs/github-integration) etc.

For retrieving list of deployments (and/or their snapshots) please use [Get all deployments](https://support.speedcurve.com/reference/get-all-deployments) endpoint.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "speedcurve-api-v2-beta",
    "version": "2.1.0"
  },
  "servers": [
    {
      "url": "https://api.speedcurve.com/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/accounts/{account_id}/snapshots": {
      "get": {
        "summary": "Get all snapshots",
        "description": "Get list of snapshots.",
        "operationId": "get-all-snapshots",
        "parameters": [
          {
            "name": "account_id",
            "in": "path",
            "description": "Account ID",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          },
          {
            "name": "start_timestamp",
            "in": "query",
            "description": "UNIX timestamp (seconds), max 12 months ago",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "end_timestamp",
            "in": "query",
            "description": "UNIX timestamp (seconds), max 12 months ago",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "site_id",
            "in": "query",
            "description": "Site ID (get via Get all sites endpoint - GET /accounts/{account_id}/sites)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "deploy_id",
            "in": "query",
            "description": "Deployment ID",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number for paginated request",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "description": "How many deploys are returned per page, maximum 1000",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"data\": [\n    {\n      \"deploy_id\": 123456789,\n      \"name\": \"Test deploy name 1710798056\",\n      \"description\": \"Test deploy description 1710798056\",\n      \"timestamp\": 1710798059,\n      \"snapshots\": [\n        {\n          \"snapshot_id\": 123456789,\n          \"site_id\": 123,\n          \"timestamp\": 1710798059\n        }\n      ]\n    },\n    {\n      \"deploy_id\": 1234567,\n      \"name\": \"Test deploy name 1710798056\",\n      \"description\": \"Test deploy description 1710798056\",\n      \"timestamp\": 1710798059,\n      \"snapshots\": [\n        {\n          \"snapshot_id\": 123456789,\n          \"site_id\": 123,\n          \"timestamp\": 1710798059\n        }\n      ]\n    }\n}"
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```