List Cards - Naïve

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

Parameter	Type	Required	Description
`agent_id`	string	No	Filter 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 list --agent-id <uuid>

MCP

Tool: naive_cards_list

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

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"
    }
  ]
}