Ramp Hello World Skill | Agent Skills

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

| Error | Cause | Solution | |-------|-------|----------| | Empty results | No data in sandbox | Create test cards first | | 403 Forbidden | Insufficient permissions | Check API app permissions | | 400 Bad date format | Wrong date format | Use ISO 8601: YYYY-MM-DD |

Resources

Next Steps

Issue virtual cards: ramp-core-workflow-a

Agent Skills: Ramp Hello World

Install this agent skill to your local

Skill Files