> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knoxcall.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Secret

> Returns metadata for a single secret — the encrypted value is not included

## Get Secret

```http theme={"dark"}
GET /v1/secrets/:id
```

Returns metadata for a single secret. The encrypted value is **not** included.

### Path Parameters

| Parameter | Type | Description   |
| --------- | ---- | ------------- |
| `id`      | uuid | The secret ID |

### Response

```json theme={"dark"}
{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "STRIPE_API_KEY",
    "shortcode_name": "STRIPE_API_KEY",
    "base_environment": "production",
    "secret_type": "string",
    "collection_id": null,
    "created_at": "2026-01-15T09:30:00.000Z",
    "environment_count": 3,
    "expires_at": null,
    "strict_expiry_enforcement": false
  },
  "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}
```

### Errors

| Status | Type        | Description      |
| ------ | ----------- | ---------------- |
| 404    | `not_found` | Secret not found |
