Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/ramp-hello-world/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill ramp-hello-world. Copyright stays with the author (MIT).

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