Ramp ACTION
List Transactions
Retrieve a paginated list of Ramp transactions, optionally filtered by department, location, or state. Returns a compact summary of each transaction by default (id, merchant_name, amount, merchant_amount, sk_category_name, state, card_id, limit_id, accounting_date, user_transaction_time, memo); use Get Transaction for the full record, or pass
fields to include specific extra fields. Use this to find transaction IDs for Get Transaction. Returns one page of up to pageSize results (max 100); a page.next value in the response means more transactions exist beyond this page. See the documentation- Action
- Read only
- OAuth
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Ramp account once, then configure and run List Transactions from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "ramp-list-transactions",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
ramp: { authProvisionId: "apn_xxxxxxx" },
departmentId: "Department ID",
locationId: "Location ID",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "ramp-list-transactions",
"configured_props": {
"ramp": { "authProvisionId": "apn_xxxxxxx" },
"departmentId": "Department ID",
"locationId": "Location ID"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "ramp",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "ramp-list-transactions",
arguments: {
departmentId: "Department ID",
locationId: "Location ID",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
departmentId Department ID | string | Filter by department ID — a Ramp UUID, e.g. fffe6c22-698f-4dc5-b2b1-b35f86947d90. Run the List Departments action to find valid IDs. Optional |
locationId Location ID | string | Filter by location ID — a Ramp UUID, e.g. 961c6f01-5719-4f4c-8fef-4096a031f32a. Run the List Locations action to find valid IDs. Optional |
state State | string | Filter by transaction state. Optional |
pageSize Page Size | integer | Number of results per page, between 2 and 100 (default 20). Optional |
start Start (Pagination Cursor) | string | Pagination cursor for the next page. Take the start query-parameter value from the previous response's page.next URL and pass it here. Optional |
fields Fields | string[] | Optional list of transaction fields to include per record in addition to the compact default (e.g. line_items, disputes, card_holder). Leave empty for the compact summary; use Get Transaction for the complete record. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- ramp-list-transactions
- Version
- 0.0.3
- App
- Ramp
- Authentication
- OAuth
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗