# Expiry

One call answers it: `GET /api/agents/:id/term`

```json
{ "term": { "mode": "trial", "stopsAt": "2026-09-15T10:00:00.000Z", "deletesAt": "2026-09-18T10:00:00.000Z",
            "paidTill": null, "paidProvider": null, "renewUrl": "https://agentspodium.com/agents/agt_…?tab=billing" } }
```

| mode | meaning | what the dates say |
|---|---|---|
| `trial` | free week from creation | `stopsAt` = created + 7 days (pod paused), `deletesAt` = + 3 more days |
| `grace` | a paid subscription stopped verifying | `stopsAt` = when it lapsed, `deletesAt` = + 3 days |
| `paid` | active subscription | `paidTill` = end of the paid period; no stop or delete dates |
| `internal` | our own pods | never expires |

Before `deletesAt` everything is exportable (`GET /api/agents/:id/export`) and a payment reactivates the pod in place. After it the pod and its data are gone. Three days before deletion the owner gets an e-mail.

To renew: pay ([payment](payment.md)) or open `renewUrl` in a browser.
