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

# List secrets

`GET /v1/secrets`

Returns a list of secrets in your project.

## Query parameters

- `starting_after` string
- `limit` integer

## Response `200`

OK

- ListSecretsResponse
  - `secrets` Secret[], required
    - `id` string, required
    - `name` string, required

## Other responses

- `401` — Unauthenticated error response

## Changes

- **2025-04-24** `f9777846c474` — 2 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `starting_after`
- **2025-02-05** `4ca61d8b4e33` — 1 breaking
  - the `code` response's property type/format changed from `integer`/`int32` to `integer`/`` for status `401`
- **2024-11-06** `6a6ef20cc3e9` — 2 info
  - api operation id `listSecrets` was added
  - api tag `Secret` added
- **2024-10-31** `333818f2f208` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/riza-io/apis/execute/changes/v1/secrets/get.md)

---

[API](https://skmtc.dev/riza-io/apis/execute.md) · [All operations](https://skmtc.dev/riza-io/apis/execute/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/riza-io/execute/revisions/bab65e0b0c2b/schema)