---
title: Errori
description: Codici di stato, codici di errore e cosa fare in ciascun caso.
sidebar:
  order: 6
---
Tutti gli errori hanno la stessa struttura:

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_error",
    "message": "`kg` is invalid: Too small: expected number to be >=1.",
    "param": "kg"
  }
}
```

`param` indica il campo della richiesta che causa l’errore, se presente. Ogni risposta include un’intestazione `Request-Id`: la indichi quando contatta l’assistenza.

| Stato | Codice | Riprovare? | Cosa fare |
| --- | --- | --- | --- |
| 400 | `invalid_json` | No | Invii un oggetto JSON di massimo 10 KB. |
| 400 | `idempotency_key_missing` / `idempotency_key_invalid` | No | Invii una [Idempotency-Key](/docs/it/idempotency) valida. |
| 401 | `invalid_api_key` | No | Verifichi la chiave: potrebbe essere stata revocata. |
| 402 | `insufficient_balance` | Dopo una ricarica | L’errore include `balance_cents` e `required_cents`. |
| 403 | `api_access_inactive` | No | L’account non è approvato oppure è sospeso. Contatti l’assistenza. |
| 403 | `insufficient_permissions` | No | Usi una chiave con accesso agli acquisti. |
| 404 | `resource_missing` / `not_found` | No | Verifichi l’ID della compensazione o il percorso. |
| 409 | `idempotency_key_reused` | No | Usi una nuova chiave di idempotenza per ogni nuovo acquisto. |
| 422 | `validation_error` | No | Corregga il campo indicato in `param`. |
| 422 | `amount_too_small` | No | Alla sua tariffa, l’importo acquista meno di 1 kg. |
| 429 | `rate_limited` | Sì | Attenda il numero di secondi indicato in `Retry-After`. |
| 500 | `api_error` | Sì | Riprovi con la stessa Idempotency-Key. |