CLI

Commands and resources

How to discover Ramp CLI commands, resources, flags, and agent-friendly output.

The CLI is organized into commands (setup and configuration) and resources (Ramp objects with their own tools). The live CLI is the source of truth, so run ramp --help and ramp <resource> --help when you need the exact current list.

Commands

CommandDescription
authLogin, logout, check status
configGet / set CLI configuration
envShow or set the default environment (sandbox / production)
applicationsApply for a Ramp account
skillsBrowse and install agent skill instructions
feedbackSubmit feedback about the CLI

Resources

Usage: ramp <resource> <tool> [OPTIONS]

Common resource groups include:

ResourceTools
accountingCategories and coding helpers
billsBill search, lookup, drafts, attachments, and eligible actions
fundsFund lookup and Agent Card-related fund operations
generalComments, explanations, Help Center, and policy helpers
purchase_orderssearch, get
receiptsReceipt upload and attachment workflows
reimbursementsReimbursement lookup and eligible user actions
requestsRequest lookup and eligible actions
transactionsTransaction lookup, missing items, memo suggestions, and eligible actions
travelTrips, bookings, and locations
usersme, search, org-chart

Exact tools can change as the CLI ships. Prefer ramp <resource> --help before writing durable scripts.

Global flags

These work with any command:

FlagBehavior
--env, -esandbox (default) or production
--output, -oOutput format: json or table
--quiet, -qSuppress progress output
--no-inputDisable interactive prompts (for CI / scripts)

Per-tool flags

Common patterns available on individual tools:

FlagBehavior
--json TEXTRaw JSON request body (bypasses flags)
--dry_run, -nPrint the request without sending it
--page_size NResults per page
--next_page_cursorResume pagination from a previous response

Example

List your own transactions with a smaller page size:

ramp transactions list --transactions_to_retrieve my_transactions --page_size 25

For agent loops, combine structured output with non-interactive flags:

ramp transactions list --agent --no-input --quiet --env production