---
title: "List secrets"
method: GET
path: "/v1/apps/secrets"
---

# List secrets

`GET /v1/apps/secrets`

List all secrets stored on the given scope.

## Query parameters

- `ending_before` string
- `expand` string[]
- `limit` integer
- `scope` object, required
  - `type` 'account' | 'user', required
  - `user` string
- `starting_after` string

## Response `200`

Successful response.

- object
  - `data` AppsSecret[], required
    - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
    - `deleted` boolean — If true, indicates that this secret has been deleted
    - `expires_at` integer, nullable — The Unix timestamp for the expiry time of the secret, after which the secret deletes.
    - `id` string, required — Unique identifier for the object.
    - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `name` string, required — A name for the secret that's unique within the scope.
    - `object` 'apps.secret', required — String representing the object's type. Objects of the same type share the same value.
    - `payload` string, nullable — The plaintext secret value to be stored.
    - `scope` SecretServiceResourceScope, required
      - `type` 'account' | 'user', required — The secret scope type.
      - `user` string — The user ID, if type is set to "user"
  - `has_more` boolean, required — True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required — String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required — The URL where this list can be accessed.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stripe/apis/stripe-api.md) · [All operations](https://skmtc.net/stripe/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/stripe-api/versions/707de00b0616/schema)