---
title: "Get your subscription state and payment history"
method: GET
path: "/v1/agent/billing-history"
tags: ["Account"]
---

# Get your subscription state and payment history

`GET /v1/agent/billing-history`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/v1/agent/billing-history`
- Auth: `ApiKeyAuth` (a scheme the document does not define)

Billing-portal-lite for paid agents. Requires a stored Pioneer or
Syndicate API key (the key is bound to the paying wallet). Returns the
current subscription state (tier, expiry, auto_renew=false — prepaid
30-day terms) plus the append-only payment ledger: one row per
verified on-chain USDC payment, newest first. Renewals append rows;
history is never overwritten.

## Headers

- `X-ClawHub-Skill` string

## Response `200`

Subscription state and payment ledger

- object
  - `ok` boolean, required
  - `wallet` string, required
  - `subscription` object, required
    - `tier` string, nullable
    - `expires_at` string, date-time, nullable
    - `active` boolean
    - `auto_renew` boolean
  - `payments` object[], required
    - `kind` string
    - `tier` string, nullable
    - `amount_usdc` number, nullable
    - `tx_hash` string, nullable
    - `chain_id` integer, nullable
    - `verified_at` string, date-time
    - `created_at` string, date-time

## Other responses

- `402`: Payment required (free tier has no billing history)
- `403`: Pioneer or Syndicate subscription required
- `503`: Billing ledger temporarily unavailable

---

[API](https://skmtc.dev/farmdash/apis/farmdash-agent-api.md) · [All operations](https://skmtc.dev/farmdash/apis/farmdash-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/farmdash/apis/farmdash-agent-api/revisions/96310281f58c?raw)