name: ramp-hello-world description: "Ramp hello world \u2014 corporate card and expense management API integration.\n
Use when working with Ramp for card management, expenses, or accounting sync.\n
Trigger with phrases like "ramp hello world", "ramp-hello-world", "corporate
\ card API".\n" allowed-tools: Read, Write, Edit, Bash(npm:), Bash(curl:), Grep version: 2.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io tags:

• saas
• ramp
• fintech
• expenses
• corporate-cards compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw

Ramp Hello World

Overview

List cards, get transactions, and check user details using the Ramp API.

Prerequisites

• Completed ramp-install-auth with valid access token

Instructions

Step 1: List Virtual Cards

resp = requests.get(f"{BASE}/cards", headers=headers, params={"page_size": 10})
for card in resp.json()["data"]:
    print(f"Card: {card['display_name']} — Limit: ${card['spending_restrictions']['amount']/100:.2f}")
    print(f"  Status: {card['state']}, Last4: {card['last_four']}")

Step 2: Get Recent Transactions

resp = requests.get(f"{BASE}/transactions", headers=headers, params={
    "start_date": "2026-01-01",
    "page_size": 10,
})
for tx in resp.json()["data"]:
    print(f"${tx['amount']/100:.2f} at {tx['merchant_name']} — {tx['sk_category_name']}")

Step 3: List Users

resp = requests.get(f"{BASE}/users", headers=headers, params={"page_size": 10})
for user in resp.json()["data"]:
    print(f"  {user['first_name']} {user['last_name']} — {user['role']}")

Output

• Cards listed with limits and status
• Recent transactions with merchant details
• Users with role information

Error Handling

Resources

• Ramp API Documentation
• Cards and Funds

Next Steps

Issue virtual cards: ramp-core-workflow-a