List backups - VPSBG's dev hub

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

page

integer

optional

Which page of paginated results to return.

filter[date]

string

optional

Filter by snapshot's creation date. Format: YYYY-MM-DD

filter[server_id]

integer

optional

Filter snapshots by server's ID.

filter[size]

integer

optional

Filter by size >=

sort

string

optional

Sorting parameter. Possible values: date (ascending), -date (descending)

Header Params

Accept

string

required

Default:

application/json

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request GET 'https://api.vpsbg.eu/v1/backups?page&filter[date]&filter[server_id]&filter[size]&sort' \
--header 'Accept;'

Responses

🟢200List of all backups.

application/json

Body

data

array[object (Backup) {7}]

optional

id

integer

optional

server_id

integer

optional

The server from which this backup was taken from.

server_hostname

string

optional

Example:

ubuntu-2gb

server_ip

string

optional

Example:

87.120.37.0

name

string

optional

created_at

string <date-time>

optional

When the backup was made (ISO8601).

size

integer

optional

The size of the server when the backup was taken. If the backup has to be restored, it can be restored to a machine with more or equal disk size.

links

object

optional

first

string

optional

last

string

optional

meta

object

optional

current_page

integer

optional

from

integer

optional

last_page

integer

optional

links

array [object {3}]

optional

path

string

optional

per_page

integer

optional

to

integer

optional

total

integer

optional

Example

{
  "data": [
    {
      "id": 77,
      "server_id": 2478,
      "server_hostname": "ubuntu-2gb",
      "server_ip": "87.120.37.0",
      "name": "71_ubuntu-2gb_2023_06_19-19_34_40.qcow2.gz",
      "created_at": "2023-06-19T22:36:35+03:00",
      "size": 50
    },
    {
      "id": 73,
      "server_id": 2448,
      "server_hostname": "ubuntu-2gb",
      "server_ip": "87.120.37.0",
      "name": "40_ubuntu-2gb_2023_06_10-14_42_22.qcow2.gz",
      "created_at": "2023-06-12T10:52:53+03:00",
      "size": 50
    }
  ],
  "links": {
    "first": "https://api.vpsbg.eu/v1/backups?page=1",
    "last": "https://api.vpsbg.eu/v1/backups?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "pagination.previous",
        "active": false
      },
      {
        "url": "https://api.vpsbg.eu/v1/backups?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": null,
        "label": "pagination.next",
        "active": false
      }
    ],
    "path": "https://api.vpsbg.eu/v1/backups",
    "per_page": 50,
    "to": 6,
    "total": 6
  }
}

🔴500Server Error