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.