List vaults - Qoder CN Series - Alibaba Cloud Documentation Center

Request headers

Header	Required	Description
`Authorization`	Yes	Bearer token used to authenticate the request. Format: `Bearer $QODER_PAT`.

Query parameters

Parameter	Type	Required	Description
`limit`	integer	No	Maximum number of vaults to return per page.
`after`	string	No	Pagination cursor. Returns records that come after this vault ID.
`status`	string	No	Filters results by vault status. One of `active` or `archived`.

For the full pagination specification, see Pagination.

Example request

# List all vaults
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/vaults" \
  -H "Authorization: Bearer $QODER_PAT"

# Paginated request
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/vaults?limit=2" \
  -H "Authorization: Bearer $QODER_PAT"

# Filter by status
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/vaults?status=archived" \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "vault_019e3bb940277f0db05ab74291acf6ef",
      "type": "vault",
      "display_name": "my-mcp-vault",
      "status": "active",
      "metadata": {},
      "created_at": "2026-05-18T15:34:16.874877Z",
      "updated_at": "2026-05-18T15:34:16.874877Z"
    }
  ],
  "first_id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "last_id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "has_more": false
}

Empty result:

{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

Response fields

Field	Type	Description
`data`	array	Array of vault objects on the current page.
`first_id`	string \| null	ID of the first vault on the page, or `null` when the page is empty.
`last_id`	string \| null	ID of the last vault on the page. Pass this value as `after` to fetch the next page. Returns `null` when the page is empty.
`has_more`	boolean	`true` if additional vaults are available; otherwise `false`.

Errors

HTTP	Type	Trigger
401	`authentication_error`	The authentication token is missing or invalid.

For the full error envelope, see Errors.