---
title: "List Secrets."
method: GET
path: "/v1/secrets"
tags: ["secrets"]
---

# List Secrets.

`GET /v1/secrets`

List all Secrets for the authenticated account. Secret values are not included for security reasons.

## Query parameters

- `limit` integer

## Response `200`

Successfully retrieved list of Secrets. Values are omitted for security.

- SecretListView — A paginated list of Secrets.
  - `secrets` SecretView[], required — List of Secret objects. Values are omitted for security.
    - `id` string, required — The unique identifier of the Secret.
    - `name` string, required — The globally unique name of the Secret. Used as the environment variable name in Devboxes.
    - `create_time_ms` integer, required — Creation time of the Secret (Unix timestamp in milliseconds).
    - `update_time_ms` integer, required — Last update time of the Secret (Unix timestamp in milliseconds).
  - `has_more` boolean, required — True if there are more results available beyond this page.
  - `total_count` integer, nullable — Total number of Secrets across all pages.

## Other responses

- `401` — Unauthorized. Invalid or missing authentication.
- `403` — Forbidden. Account does not have devbox capability.
- `500` — Internal server error.

## Changes

- **2026-03-24** `32e4b2dfb757` — 1 warning
  - removed the optional property `remaining_count` from the response with the `200` status
- **2026-02-19** `8704a652545c` — 4 breaking
  - the response property `remaining_count` became nullable for the status `200`
  - the response property `total_count` became nullable for the status `200`
  - the response property `remaining_count` became optional for the status `200`
  - the response property `total_count` became optional for the status `200`

[Change history](https://skmtc.dev/runloopai/apis/runloop-api/changes/v1/secrets/get.md)

---

[API](https://skmtc.dev/runloopai/apis/runloop-api.md) · [All operations](https://skmtc.dev/runloopai/apis/runloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runloopai/runloop-api/revisions/e9dc776053e4/schema)