ramp-spend-analysis

Analyze Ramp card transactions and bill payments by vendor, category, or team over a date range.

2|1|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/ramp-public/skills --skill ramp-spend-analysis-ramp-public
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ramp-spend-analysis
Source: https://github.com/ramp-public/skills/tree/main/plugins/ramp/skills/ramp-spend-analysis
Command: npx skills add https://github.com/ramp-public/skills --skill ramp-spend-analysis-ramp-public

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Answering "how much did we spend on X" requires pulling data from two separate Ramp resources — card transactions and bill payments — with no unified spend endpoint, plus handling inconsistent amount formats, pagination, and vendor name variants. This Skill provides a complete workflow for producing accurate vendor spend reports without double-counting or missing pages. ## Core Features & Use Cases - Vendor Spend Analysis: Query card transactions and bill payments for a specific vendor or all vendors over a date range, then aggregate into a spend table. - AI and Token Spend Reporting: Combine financial spend with estimated token cost via ramp ai-spend commands, reported separately to avoid overlap. - Data Integrity Guardrails: Handles string vs numeric amount formats, refunds, pagination via next_page_cursor, vendor name variant detection, and the rule that bill invoice amounts are not paid-in-period spend. - Use Case: A finance lead asks for a full SaaS vendor breakdown for Q1. The Skill pulls all transactions and bills with payment activity, paginates to completion, groups by merchant, flags name variants like "Delta Air Lines" vs "Delta Airlines", and presents a table separating confirmed card spend from bills requiring payment-allocation data. ## Quick Start Ask the agent to analyze how much your company spent on a specific vendor this quarter, including both card transactions and bill payments.

Frequently Asked Questions about ramp-spend-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze vendor spend in Ramp?

Query both card transactions with ramp transactions list and bill payments with ramp bills search over the same date range, then aggregate by merchant. There is no unified spend endpoint, so both resources must be queried and merged separately.

How do I track AI and token spend across vendors?

Run ramp ai-spend to see available token-spend commands and query the one matching your scope, alongside transactions and bills for financial spend. Report token cost and financial spend separately since they can overlap and must never be added together.

Why can't I sum bill amounts as actual spend?

A bill's amount field is the full invoice amount, not the paid-in-period amount. A payment-date match may represent only one partial installment, so a complete paid total requires payment-allocation amounts and dates from another source.

Why does my Ramp spend report miss transactions?

A single page may not return everything, so paginate until next_page_cursor is null. Also check vendor name variants like "AWS" versus "Amazon Web Services", since the API does not normalize merchant names.

When should I not use spend analysis in Ramp?

Do not use it for approving transactions, uploading receipts, or verifying a single bill payment. Use ramp-approval-dashboard, ramp-complete-expenses, or ramp-payment-lookup for those tasks respectively.