ramp-payment-lookup

Look up vendor bill payments and verify payment status via the Ramp CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finance teams often need quick answers to questions like "did we pay this vendor?" without digging through a web dashboard. This Skill lets an AI agent search Ramp bills, verify payment status, and pull invoice details directly from the terminal. ## Core Features & Use Cases - Bill Search: Query bills by vendor name, invoice number, or payment ID, with pagination and draft filtering. - Payment Verification: Drill into bill details to confirm payment status, payment method (ACH, check, wire), and payment date. - Approval History & Attachments: Retrieve approval/modification history and invoice attachments for submitted bills. - Use Case: A user asks "Did we pay DHL this month?" The agent searches bills, confirms the invoice was paid $1,287.95 via ACH on April 14, and reports the result. ## Quick Start Ask the agent to check whether a specific vendor bill has been paid, for example by saying "did we pay DHL this month?"

Frequently Asked Questions about ramp-payment-lookup

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

FAQPage Schema
How do I check if a vendor bill was paid in Ramp?▼

Search bills with ramp bills search using the vendor name or invoice number, including the --include_paid flag to surface completed bills. Then run ramp bills get on the bill ID to confirm payment status, method, and date.

How do I find a bill by invoice number in Ramp?▼

Use ramp bills search --query with the invoice number; the query matches payee name, invoice number, and payment ID, and partial matches work. Paginate with --page_cursor if next_page_cursor is returned.

Why does my Ramp bills command return HTTP 422?▼

The Ramp agent tools require a --rationale flag with a non-empty string on every command. Omitting it returns HTTP 422 (DEVELOPER_INVALID_SCHEMA); with --json, supply it as a rationale key in the body.

Can I see who approved a bill in Ramp?▼

Yes, run ramp bills history --bill_id <bill_id> to retrieve approval and modification history. The bills get command does not include approval history, and history is only available for submitted bills, not drafts.

When should I not use bill payment lookup?▼

Do not use it for approving or rejecting bills, analyzing spend across multiple vendors, or uploading receipts. Those workflows belong to approval dashboards, spend analysis, and expense completion tools respectively.