---
title: "Get a Secret"
method: GET
path: "/v1/secrets/{id}"
---

# Get a Secret

`GET /v1/secrets/{id}`

## Request

- Base URL: `https://api.browserbase.com`
- URL: `https://api.browserbase.com/v1/secrets/{id}`
- Auth: API key in header `X-BB-API-Key`

## Path parameters

- `id` string, uuid, required

## Response `200`

The secret metadata.

- Secret
  - `id` string, required: Unique identifier of the secret.
  - `secretKey` string, required: The name the secret value is stored under.
  - `createdAt` string, date-time: Time at which the secret was created, in UTC, using RFC 3339 format, e.g. 2026-01-19T00:00:00.000Z.
  - `updatedAt` string, date-time: Time at which the secret's value was last set, in UTC, using RFC 3339 format, e.g. 2026-01-20T00:00:00.000Z.

## Other responses

- `400`: Invalid secret ID. The ID must be a UUID.
- `404`: The secret does not exist in the project.

## Changes

- **2026-10-30** `3661c37195a7`: 2 info
  - added the optional property `createdAt` to the response with the `200` status
  - added the optional property `updatedAt` to the response with the `200` status
- **2026-10-16** `266d5199a560`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/browserbase/apis/browserbase-api/changes/v1/secrets/:id/get.md)

---

[API](https://skmtc.dev/browserbase/apis/browserbase-api.md) - [All operations](https://skmtc.dev/browserbase/apis/browserbase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/browserbase/apis/browserbase-api/revisions/106c5f72c742?raw)