Agent skill

ramp-hello-world

Ramp hello world — corporate card and expense management API integration. Use when working with Ramp for card management, expenses, or accounting sync. Trigger with phrases like "ramp hello world", "ramp-hello-world", "corporate card API".

Stars 1,803
Forks 241

Install this agent skill to your Project

npx add-skill https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/main/plugins/saas-packs/ramp-pack/skills/ramp-hello-world

SKILL.md

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

python
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

python
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

python
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

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results