---
title: "Find out when this agent's current free or paid term ends."
method: GET
path: "/agents/{id}/term"
tags: ["Agents"]
---

# Find out when this agent's current free or paid term ends.

`GET /agents/{id}/term`

## Request

- Base URL: `https://agentspodium.com/api`
- URL: `https://agentspodium.com/api/agents/{id}/term`
- Auth: HTTP bearer

Call to decide whether to renew soon — the same numbers the account page's countdown uses. `renewUrl` is where a human pays.

## Path parameters

- `id` string, required

## Response `200`

OK.

- object
  - `term` AgentTerm, required: The one answer to when this agent's current term ends.
    - `mode` 'trial' | 'grace' | 'paid' | 'internal', required
    - `stopsAt` string, date-time, nullable, required: When a free agent's pod is paused (trial/grace only).
    - `deletesAt` string, date-time, nullable, required: When a free agent is deleted for good (trial/grace only).
    - `paidTill` string, date-time, nullable, required: End of the current paid period (paid only).
    - `paidProvider` string, nullable, required
    - `renewUrl` string, uri, required: Where a human pays to renew this agent.

## Other responses

- `400`: Term information is not available on this deployment.
- `401`: Missing, invalid, expired, or revoked credential.
- `404`: No such agent, key, or persona for this account.

---

[API](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset.md) · [All operations](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/llms.txt) · [OpenAPI document](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/revisions/46b0fc821822?raw)