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

# Get Secrets

> This endpoint gets secrets.

<Warning>
  **Verify deployment access.** This reference describes an API contract, not a provisioned
  public service. Check the dated [host report](/api-reference/hosts) and obtain the correct
  host, API version, and workspace credentials. For a current integration, start with the
  [API directory](/api-reference/introduction).
</Warning>

### Body

<ParamField body="id" type="integer">
  This is the id of the secret
</ParamField>

<Note>
  **This read takes a request body.** The Fetch standard forbids a body on `GET`,
  so `fetch()` rejects this call rather than sending one — reach for a server-side
  client (curl, `undici.request`, Python `requests`) instead. Proxies and CDNs are
  also free to drop a body on a read, so prefer a direct connection.
</Note>

### Response

<ResponseField name="id" type="number">
  This is the id of the secret.
</ResponseField>

<ResponseField name="name" type="string">
  This is the name of the secret.
</ResponseField>

<ResponseField name="description" type="string">
  This is the description of the secret.
</ResponseField>

<ResponseField name="value" type="string">
  This is the value of the secret.
</ResponseField>

<ResponseField name="created_at" type="string">
  This is the date the secret was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  This is the date the secret was updated.
</ResponseField>

### Errors

Succeeds with `200`. Failures return `400`, `401`, `403` or `429` with an error body, per the [platform status-code contract](/api-reference/errors#http-status-codes).

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://api.stateset.com/v1/secrets' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data-raw '{
      "id": 1
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": 1,
    "name": "string",
    "description": "string",
    "value": "string",
    "created_at": "string",
    "updated_at": "string"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.