payment-lookup

Search Ramp vendor bills and return exact payment status details.

45|6|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/ramp-public/ramp-cli --skill payment-lookup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: payment-lookup
Source: https://github.com/ramp-public/ramp-cli/tree/main/src/ramp_cli/skills/payment-lookup
Command: npx skills add https://github.com/ramp-public/ramp-cli --skill payment-lookup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you confirm whether a specific vendor bill was paid and retrieve the exact payment status and related details directly from Ramp, reducing the back-and-forth of manual checking.

Core Features & Use Cases

  • Search-first bill discovery: Searches bills by vendor name, invoice number, payee/payee-like terms, and payment ID, with support for including paid bills via include_paid.
  • Payment detail enrichment: Pulls full bill/payment details using bills get, including approval history and payment metadata where available.
  • Invoice document cross-reference: Fetches associated invoice attachments via bills attachments for verification and record keeping.
  • Use case: You need to answer “Was this bill paid?” for a vendor and, if needed, confirm the exact invoice and payment status (without performing approvals or spend analysis).

Quick Start

Run payment-lookup to find the bill for a vendor and show its payment and approval status using a search that includes already-paid items.

Frequently Asked Questions about payment-lookup

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

FAQPage Schema
How do I check if a vendor bill payment went out in Ramp?

To verify a bill payment status in Ramp, you search for the vendor bill by name or invoice number, retrieve the exact payment details, and confirm whether the transaction was completed without manual checking.

Can I retrieve invoice attachments when looking up a bill payment?

Yes, invoice attachment retrieval is supported during a bill lookup. You can fetch associated invoice documents via the attachments endpoint to cross-reference records and verify payment status alongside the original files.

How do I search for already paid bills in Ramp?

You can search for paid bills by applying the include_paid parameter during your bill discovery query. This ensures that completed bill payments appear in your search results alongside any pending or outstanding invoices.

Does the Ramp bill lookup return approval history and payment metadata?

Yes, the bill lookup process enriches payment details by retrieving full bill information, including available approval history and payment metadata, returning exact API fields without making inferences about the data.

What is the best way to look up a bill by invoice number from the terminal?

The best way to look up a bill by invoice number from the terminal is using a search-first CLI tool that queries the vendor bill, enriches the payment details, and normalizes amount units to verify the payment status.

Are there limitations when verifying bill payment status via the Ramp CLI?

This bill payment status lookup is limited to search, detail enrichment, and attachment retrieval; it does not support performing bill approvals or conducting spend analysis on the retrieved vendor payment data.