Skip to main content
GET
/
v1
/
cards
/
transactions
curl "https://api.usenaive.ai/v1/cards/transactions?card_id=card-uuid-1&limit=10" \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "transactions": [
    {
      "id": "txn-uuid-1",
      "card_id": "card-uuid-1",
      "amount_cents": 1500,
      "merchant_name": "OpenAI",
      "description": "GPT-4 API usage",
      "agent_id": "agent-uuid-1",
      "metadata": {},
      "created_at": "2026-03-15T14:30:00Z"
    },
    {
      "id": "txn-uuid-2",
      "card_id": "card-uuid-1",
      "amount_cents": 2999,
      "merchant_name": "AWS",
      "description": "EC2 instance",
      "agent_id": null,
      "metadata": {},
      "created_at": "2026-03-14T09:15:00Z"
    }
  ]
}
Returns transactions across all cards. Supports filtering by card, agent, and pagination via limit.

​
Query Parameters

ParameterTypeRequiredDescription
card_idstringNoFilter transactions for a specific card
agent_idstringNoFilter transactions by agent
limitnumberNoMaximum number of transactions to return (default: 50)
curl "https://api.usenaive.ai/v1/cards/transactions?card_id=card-uuid-1&limit=10" \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "transactions": [
    {
      "id": "txn-uuid-1",
      "card_id": "card-uuid-1",
      "amount_cents": 1500,
      "merchant_name": "OpenAI",
      "description": "GPT-4 API usage",
      "agent_id": "agent-uuid-1",
      "metadata": {},
      "created_at": "2026-03-15T14:30:00Z"
    },
    {
      "id": "txn-uuid-2",
      "card_id": "card-uuid-1",
      "amount_cents": 2999,
      "merchant_name": "AWS",
      "description": "EC2 instance",
      "agent_id": null,
      "metadata": {},
      "created_at": "2026-03-14T09:15:00Z"
    }
  ]
}

​
CLI

naive cards transactions
With filters: 
naive cards transactions --card-id <uuid> --agent-id <uuid> --limit 20

​
MCP

Tool: naive_cards_transactions 
{
  "card_id": "card-uuid-1",
  "agent_id": "agent-uuid-1",
  "limit": 10
}