---
title: "List settings (Admin); the D-20 registry grouped by category, plus every root-of-trust key rendered read-only; a secret value is always {set, updated_at}, never the value"
method: GET
path: "/api/v1/admin/settings"
tags: ["admin"]
---

# List settings (Admin); the D-20 registry grouped by category, plus every root-of-trust key rendered read-only; a secret value is always {set, updated_at}, never the value

`GET /api/v1/admin/settings`

## Request

- Base URL: `https://amplerun-api.spiry.org`
- URL: `https://amplerun-api.spiry.org/api/v1/admin/settings`
- Auth: HTTP bearer

## Response `200`

Settings grouped by category.

- object
  - `categories` object[], required
    - `category` 'branding' | 'contact' | 'money' | 'mail' | 'alerts' | 'auth-providers' | 'chain-access' | 'operations', required
    - `settings` SettingView[], required
      - `key` string, required
      - `category` 'branding' | 'contact' | 'money' | 'mail' | 'alerts' | 'auth-providers' | 'chain-access' | 'operations', required
      - `label` string, required
      - `help` string, required
      - `secret` boolean, required
      - `editable` boolean, required: False for a root-of-trust key — refused at the API, read-only in the UI.
      - `pinned_reason` string, nullable, required
      - `value` unknown, required
      - `source` 'database' | 'environment' | 'default', required
      - `version` integer, required
      - `updated_at` string, date-time, nullable, required
      - `updated_by` string, nullable, required
      - `env` string, required

## Other responses

- `default`: Error envelope. 401 unauthenticated, 403/404 forbidden, 409 conflict, 422 invalid input, 429 rate limited (code UNAVAILABLE, retryable:true, no Retry-After header), 503 unavailable money/provider state with retryable:true.

---

[API](https://skmtc.dev/amplerun/apis/amplerun-business-api.md) · [All operations](https://skmtc.dev/amplerun/apis/amplerun-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/amplerun/apis/amplerun-business-api/revisions/40944687fa52?raw)