Cards
List Transactions
List card transactions across all cards
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.
With filters:
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
card_id | string | No | Filter transactions for a specific card |
agent_id | string | No | Filter transactions by agent |
limit | number | No | Maximum 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
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
}
⌘I
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"
}
]
}