# List Backups

Endpoint: GET /v1/backups
Security: httpAuth

## Security:

  - `httpAuth` (unknown)
    http bearer

## Query parameters:

  - `limit` (integer)
    The number of entities to return.

  - `startingAfter` (string)
    Entity id used to the determine beginning of query results.

  - `sortBy` (string)
    Property name used to sort the query results.

  - `sortOrder` (string)
    Sort order applied to the query results.

  - `vaultId` (string)
    Return entities matching given vault id.

  - `lastOnly` (boolean)
    Return entities with acknowledged status and limits results to latest one.

  - `acknowledged` (boolean)
    Return entities with acknowledged status equals true.

  - `data.type` (string)
    Return entities that matches given type.

  - `metadata.createdBy` (string)
    Return entities that were created by matching user.

  - `metadata.lastModifiedBy` (string)
    Return entities that were last modified by matching user.

  - `metadata.description` (string)
    Return entities with descriptions that contains or equals to provided description.

  - `metadata.customProperties` (array)
    Return entities that contains provided custom properties.

  - `additionalDetails.processingStatus` (string)
    Return entities matching given processing status.

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.id` (string, required)

  - `items.data` (any, required)

  - `items.data.vaultId` (string, required)

  - `items.data.acknowledged` (boolean, required)

  - `items.data.type` (string, required)
    Enum: "VaultHSM", "VaultMPC"

  - `items.metadata` (object, required)

  - `items.metadata.description` (string)

  - `items.metadata.revision` (integer, required)

  - `items.metadata.createdAt` (string, required)

  - `items.metadata.createdBy` (object)

  - `items.metadata.createdBy.id` (string, required)

  - `items.metadata.createdBy.domainId` (string, required)

  - `items.metadata.lastModifiedAt` (string, required)

  - `items.metadata.customProperties` (object, required)

  - `items.additionalDetails` (object)

  - `items.additionalDetails.processing` (any, required)

  - `items.additionalDetails.processing.status` (string, required)
    Enum: "Completed", "Failed", "Pending", "Preparing"

  - `count` (integer, required)

  - `currentStartingAfter` (string)

  - `nextStartingAfter` (string)

## Response 400:

  - `400` (unknown)
    Invalid value for: query parameter limit, Invalid value for: query parameter startingAfter, Invalid value for: query parameter sortBy, Invalid value for: query parameter sortOrder, Invalid value for: query parameter vaultId, Invalid value for: query parameter lastOnly, Invalid value for: query parameter acknowledged, Invalid value for: query parameter data.type, Invalid value for: query parameter metadata.createdBy, Invalid value for: query parameter metadata.lastModifiedBy, Invalid value for: query parameter metadata.description, Invalid value for: query parameter metadata.customProperties, Invalid value for: query parameter additionalDetails.processingStatus

## Response 401:

  - `401` (unknown)
    One of: Invalid JWT (InvalidJwtError); User not authorized (PermissionDeniedError)

## Response 401 fields (application/json):

  - `reason` (string, required)

  - `message` (string)

## Response 404:

  - `404` (unknown)
    Entity or Domain not found (EntityNotFoundError)

## Response 404 fields (application/json):

  - `reason` (string, required)

  - `message` (string)