# Palmyr Cards – Refresh Card Balance & Transactions

> Palmyr Cards – Refresh Card Balance & Transactions is a paid API for AI agents from palmyr.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Triggers a live sync of a card's balance and recent transactions from the card issuer, bypassing any cached data (rate-limited to once per 5 minutes per card).

## Facts

- Endpoint: POST https://palmyr.ai/cards/:id/refresh
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/palmyr-cards-refresh-card-balance-transactions-d5fa85ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y3kcXfUZ8N0-9o_jyh7_P

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability palmyr-cards-refresh-card-balance-transactions-d5fa85ac -d '<json body>'
```

Example prompt: Can you do a live refresh on my Palmyr card (card ID abc123) to get its current balance and latest transactions straight from the issuer?

## When to prefer this

Use this endpoint when you need guaranteed real-time card balance and transaction data directly from the issuer, rather than relying on potentially stale cached data. Prefer it when a user has just made a transaction and wants to verify it posted, or when a discrepancy is noticed between expected and displayed balances. Note the 5-minute per-card rate limit — avoid calling more frequently than necessary.

## Known failure modes

- Rate limit hit — card was already refreshed within the last 5 minutes; returns 429 or equivalent throttle error
- Invalid or unknown card ID — returns 404 or similar not-found error
- Card issuer temporarily unavailable — upstream timeout or 5xx error propagated
- Unauthorized — caller does not own or have access to the specified card
- Card is inactive or closed — issuer returns no data

## How this service works

Refresh a card's live balance and transactions from the issuer (rate-limited upstream: 1 per 5 min per card).

## Output

Returns the card's current live balance and a list of recent transactions as retrieved directly from the card issuer, along with a timestamp indicating when the refresh was performed. Data reflects the issuer's state at the moment of the call, not a cached snapshot.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "body": {
     "type": "object",
     "additionalProperties": true
    }
   }
  },
  "output": {
   "properties": {
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/palmyr-cards-refresh-card-balance-transactions-d5fa85ac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from palmyr.ai](https://www.zero.xyz/host/palmyr.ai/llms.txt)