> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Databases Status

> Retrieves the status of all databases owned by the authenticated user or within a specified workspace.

<ParamField query="workspace_id" type="string">
  The ID of the workspace to filter databases by. If not provided, retrieves databases owned by the user.
</ParamField>

### Response

<ResponseField name="response" type="array">
  An array of database status objects.

  <Expandable title="Toggle object">
    <ResponseField name="id" type="string">
      The ID of the database.
    </ResponseField>

    <ResponseField name="cpu" type="string">
      The CPU usage of the database container (e.g., "0.00%").
    </ResponseField>

    <ResponseField name="ram" type="string">
      The RAM usage of the database container in MB (e.g., "0.00 MB").
    </ResponseField>

    <ResponseField name="storage" type="string">
      The storage usage of the database container in MB (e.g., "0.00 MB").
    </ResponseField>

    <ResponseField name="running" type="boolean">
      Indicates whether the database container is running.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "response": [
      {
        "id": "639d9aa35d8b4e559bcd066db4ddcc8c",
        "cpu": "0.00%",
        "ram": "0.00 MB",
        "storage": "0.00 MB",
        "running": false
      },
      {
        "id": "bdd13420cc10441290ddd25961ed71e6",
        "cpu": "1.25%",
        "ram": "128.50 MB",
        "storage": "256.00 MB",
        "running": true
      }
    ]
  }
  ```
</ResponseExample>

### Error Responses

<ResponseField name="code" type="string">
  The error code indicating the reason for failure. Possible values:

  * `UNAUTHORIZED`: The user is not authenticated or lacks sufficient permissions.
  * `ORGANIZATION_NOT_FOUND`: The specified workspace does not exist.
  * `USER_NOT_IN_ORGANIZATION`: The user is not a member of the specified workspace.
</ResponseField>

<ResponseField name="message" type="string">
  A descriptive message providing additional details about the error.
</ResponseField>

<ResponseExample>
  ```json Error Response (403) theme={null}
  {
    "code": "UNAUTHORIZED"
  }
  ```

  ```json Error Response (404) theme={null}
  {
    "code": "ORGANIZATION_NOT_FOUND"
  }
  ```

  ```json Error Response (403) theme={null}
  {
    "code": "USER_NOT_IN_ORGANIZATION"
  }
  ```
</ResponseExample>