get_account

Get your Pendium account info — credit balance, plan tier, and all brand agents with latest scores.

Get your Pendium account info: credit balance, plan tier, and all your brand agents with their latest scores. This is the best starting point when connecting a new agent — it shows you what's available.

Authentication: Required

Parameters

None.

Response

{
  "plan": "starter",
  "creditBalance": 45,
  "agentCount": 3,
  "agents": [
    {
      "syntheticId": 1234,
      "name": "Example",
      "website": "https://example.com",
      "lastScanDate": "2026-03-20T12:00:00Z",
      "latestScore": 72
    },
    {
      "syntheticId": 1235,
      "name": "OtherBrand",
      "website": "https://otherbrand.com",
      "lastScanDate": "2026-03-18T08:00:00Z",
      "latestScore": 58
    }
  ],
  "upgradeUrl": "https://pendium.ai/pricing"
}

Key fields

Field	Description
`plan`	Current plan: `"free"`, `"starter"`, or `"pro"`
`creditBalance`	Remaining credits. A warning appears when balance ≤ 5.
`agents`	All brand agents owned by this account
`agents[].syntheticId`	The agent ID used in all other tool calls
`agents[].latestScore`	Most recent visibility score (0–100), or `null` if no scan

Common use

Call get_account first to discover your syntheticId values, then pass them to other tools like scan_visibility, get_report, or get_brand_voice.

Parameters

Response

Key fields

Common use

On this page