---
title: "Get"
method: GET
path: "/vault_secrets/{id}"
tags: ["Secrets"]
---

# Get

`GET /vault_secrets/{id}`

Get a Secret by ID

## Path parameters

- `id` string, required

## Headers

- `ngrok-version` integer, required

## Response `200`

Get a Secret by ID

- Secret
  - `id` string — identifier for Secret
  - `uri` string — URI of this Secret API resource
  - `created_at` string — Timestamp when the Secret was created (RFC 3339 format)
  - `updated_at` string — Timestamp when the Secret was last updated (RFC 3339 format)
  - `name` string — Name of secret
  - `description` string — description of Secret
  - `metadata` string — Arbitrary user-defined metadata for this Secret
  - `created_by` Ref
    - `id` string — a resource identifier
    - `uri` string — a uri for locating a resource
  - `last_updated_by` Ref
    - `id` string — a resource identifier
    - `uri` string — a uri for locating a resource
  - `vault` Ref
    - `id` string — a resource identifier
    - `uri` string — a uri for locating a resource
  - `vault_name` string — Name of the vault the secret is stored in

## Other responses

- `4XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.
- `5XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.

## Changes

- **2025-12-16** `602cd080d3a7` — 1 info
  - added the optional property `vault_name` to the response with the `200` status
- **2025-08-05** `51f746f31f74` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ngrok/apis/ngrok-openapi/changes/vault_secrets/:id/get.md)

---

[API](https://skmtc.dev/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.dev/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/revisions/c697539ac350/schema)