
# Ottenere un piano di configurazione

`GET /v1/config-plans/{plan_id}` · permesso `config:read` e i permessi di lettura richiesti alla creazione del piano

Restituisce un piano salvato nella stessa forma della [risposta che l'ha creato](create.md). I piani non contengono valori segreti.

## Richiesta

| Parametro | Descrizione |
|---|---|
| `plan_id` | ID del piano, `cfgp_…`. |

## Risposta

`200 OK` con `Cache-Control: no-store`. Un piano la cui ora è trascorsa e che non è stato applicato ha `status: expired`. I piani vengono eliminati 7 giorni dopo la scadenza.

## Errori

| HTTP | code | Quando |
|---|---|---|
| 401 | `unauthenticated` | Le credenziali mancano, non sono valide o sono state revocate. |
| 403 | `insufficient_permissions` | Alle credenziali manca un permesso richiesto dal piano; `required_permissions` li elenca tutti. |
| 404 | `not_found` | Il piano non esiste, appartiene a un altro ambiente o è stato eliminato. |
| 429 | `rate_limited` | Il limite di frequenza è stato superato; riprova dopo il periodo `Retry-After`. |

## Esempio

```bash
curl "https://api.eu.keenauth.com/v1/config-plans/cfgp_01m4qpqtywfs7930tb6kqn5rc5" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth config plans get cfgp_01m4qpqtywfs7930tb6kqn5rc5
```
