ramp-manage-bills

Search, inspect, and review vendor bills and invoices through the Ramp CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finance teams need quick visibility into vendor bills — what is pending, what is approved, and what needs attention — without manually navigating the Ramp web app for every lookup. ## Core Features & Use Cases - Bill Search & Listing: Find bills by vendor name, invoice number, or payment ID, with pagination and optional exclusion of paid bills. - Bill Detail Inspection: Pull full details for submitted bills or drafts, including amounts, line items, approval status, and accounting codings. - Attachments & Pending Approvals: Retrieve invoice file attachments for submitted bills and list bills awaiting the current user's approval. - Use Case: Ask your agent "what bills do we have from Acme?" and get a formatted list with amounts, statuses, due dates, and deep links into the Ramp web app. ## Quick Start Ask your agent to show all pending bills from a specific vendor and include the details and attachments for the one you select.

Frequently Asked Questions about ramp-manage-bills

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

FAQPage Schema
How do I search for vendor bills with the Ramp CLI?

Run ramp bills search with a --query matching a vendor name, invoice number, or payment ID, plus --agent for JSON output and a required --rationale string. Use ramp bills list to retrieve bills without a search query.

How do I get details for a draft bill in Ramp?

Check the is_draft field on the search result row first. Use ramp bills draft --bill_id for unsubmitted drafts and ramp bills get --bill_id for submitted bills, since get returns 404 for drafts.

Can I approve bills using the Ramp CLI?

No, bill approval is not available through these read-only CLI commands. Use the ramp-approval-dashboard skill for approvals, or follow the bill_url deep link to approve directly in the Ramp web app.

Why does my Ramp bills command return HTTP 422?

Every bills command requires a non-empty --rationale argument of up to 1024 characters. Omitting it returns HTTP 422 (DEVELOPER_INVALID_SCHEMA); with --json, supply it as a rationale key in the request body.

Why are paid bills showing up in my Ramp bill search?

Paid bills are included in search and list results by default. Pass --no-include_paid to exclude them and only see unpaid or pending bills.