List All 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
Number of items returned per page
Which 'page' of paginated results to return.
Used to filter snapshots by a resource type.
Response
A JSON object with a key of snapshots.
Example response
{
"snapshots": [
{
"id": "6372321",
"name": "web-01-1595954862243",
"created_at": "2020-07-28T16:47:44Z",
"regions": [
"nyc3",
"sfo3"
],
"min_disk_size": 25,
"size_gigabytes": 2.34,
"resource_id": "200776916",
"resource_type": "droplet",
"tags": [
"web",
"env:prod"
]
}
],
"links": {
"pages": {
"last": "https://api.digitalocean.com/v2/images?page=2",
"next": "https://api.digitalocean.com/v2/images?page=2"
}
},
"meta": {
"total": 1
}
}