List

List All Snapshots

get/v2/snapshots

To list all of the snapshots available on your account, send a GET request to /v2/snapshots.

The response will be a JSON object with a key called snapshots. This will be set to an array of snapshot objects, each of which will contain the standard snapshot attributes.

Filtering Results by Resource Type

It's possible to request filtered results by including certain query parameters.

List Droplet Snapshots

To retrieve only snapshots based on Droplets, include the resource_type query parameter set to droplet. For example, /v2/snapshots?resource_type=droplet.

List Volume Snapshots

To retrieve only snapshots based on volumes, include the resource_type query parameter set to volume. For example, /v2/snapshots?resource_type=volume.

Query Parameters

pagenumber

optional

Which 'page' of paginated results to return.

minimum1

per_pagenumber

optional

Number of items returned per page

minimum1

maximum200

resource_typeenum

optional

"droplet" OR "volume"

Used to filter snapshots by a resource type.

Hide ParametersShow Parameters

"droplet"

"volume"

Returns

metatotalnumberMetaProperties

Information about the response itself.

linkspagesunionPageLinks

optional

snapshotsarray of idstringcreated_atstringmin_disk_sizenumbernamestringregionsarray of stringresource_idstringresource_typeenumsize_gigabytesnumbertagsarray of stringSnapshots

optional

HTTPPython

curl https://api.digitalocean.com//v2/snapshots \
    -H "Authorization: Bearer $GRADIENTAI_API_KEY"

200 Example

{
  "snapshots": [
    {
      "id": "6372321",
      "name": "web-01-1595954862243",
      "created_at": "2020-07-28T16:47:44Z",
      "regions": [
        "nyc3",
        "sfo3"
      ],
      "resource_id": "200776916",
      "resource_type": "droplet",
      "min_disk_size": 25,
      "size_gigabytes": 2.34,
      "tags": [
        "web",
        "env:prod"
      ]
    },
    {
      "id": "fbe805e8-866b-11e6-96bf-000f53315a41",
      "name": "pvc-01-1595954862243",
      "created_at": "2019-09-28T23:14:30Z",
      "regions": [
        "nyc1"
      ],
      "resource_id": "89bcc42f-85cf-11e6-a004-000f53315871",
      "resource_type": "volume",
      "min_disk_size": 2,
      "size_gigabytes": 0.1008,
      "tags": [
        "k8s"
      ]
    }
  ],
  "links": {},
  "meta": {
    "total": 2
  }
}