Skip to main content
GET
/
v1
/
cards
curl https://api.usenaive.ai/v1/cards \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "cards": [
    {
      "id": "card-uuid-1",
      "name": "Marketing Card",
      "provider": "managed_virtual",
      "status": "active",
      "spending_limit_cents": 500000,
      "balance_cents": 350000,
      "agent_id": "agent-uuid-1",
      "created_at": "2026-02-01T10:00:00Z"
    },
    {
      "id": "card-uuid-2",
      "name": "Research Card",
      "provider": "prepaid_gift",
      "status": "active",
      "spending_limit_cents": 200000,
      "balance_cents": 200000,
      "agent_id": null,
      "created_at": "2026-02-05T14:00:00Z"
    }
  ]
}
Returns all virtual cards associated with your company. Optionally filter by agent assignment.

​
Query Parameters

ParameterTypeRequiredDescription
agent_idstringNoFilter cards assigned to a specific agent
curl https://api.usenaive.ai/v1/cards \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "cards": [
    {
      "id": "card-uuid-1",
      "name": "Marketing Card",
      "provider": "managed_virtual",
      "status": "active",
      "spending_limit_cents": 500000,
      "balance_cents": 350000,
      "agent_id": "agent-uuid-1",
      "created_at": "2026-02-01T10:00:00Z"
    },
    {
      "id": "card-uuid-2",
      "name": "Research Card",
      "provider": "prepaid_gift",
      "status": "active",
      "spending_limit_cents": 200000,
      "balance_cents": 200000,
      "agent_id": null,
      "created_at": "2026-02-05T14:00:00Z"
    }
  ]
}

​
CLI

naive cards
To filter by agent: 
naive cards --agent-id <uuid>

​
MCP

Tool: naive_cards_list 
{
  "agent_id": "agent-uuid-1"
}