# Perflo integration

> Pay-per-use API for AI agents: discover and pay per call for third-party data and tool services from one Perflo balance, with per-user budgets and spending keys.

- Authentication: apiKey

## Tools (31)

- **Create Agent Key**: Mint a spending key (perflo_live_) pinned to one sub-account. The secret is returned exactly once.
- **Create Sub-Account**: Create a per-user budget (sub-account) with its own hourly/daily/monthly/total caps and per-category rules.
- **Disable Sub-Account**: Disable one budget (sub-account) so it can no longer spend. History stays; re-enable with PATCH status active.
- **Get Account**: Read the account's spendable balance, sub-account count and the active account-wide spending policy usage.
- **Get Account Key**: Read the account key's metadata (name, last four, last used, revoked). Never the key string.
- **Get Balance**: Read the account's spendable balance, credit, wallet headroom, amount owed and every credit grant.
- **Get Capability**: Get one capability category with its vendors, or one group with its categories. Public, free.
- **Get Own Agent Key Budget**: An agent key reads itself: its bound sub-account and how much it can still spend in each window.
- **Get Purchased Resource**: Read one purchased resource including the goods: the vendor payload and any redemption code.
- **Get Spending Policy**: Read the account-wide spending caps with usage, expiry, recipient allowlist, on-chain grant state and the next setup step.
- **Get Statement**: Read one month's summary: opening/closing balance, totals charged, credited and settled, broken down by capability and sub-account.
- **Get Sub-Account**: Read one budget (sub-account): its remaining headroom per window, category rules and the account's spendable balance.
- **Get Task**: Read a task started with POST /v1/tasks that was still running: status, charge, output and any delivered goods.
- **Get Transaction**: Read one transaction receipt. The way to resolve a payment whose outcome is uncertain: poll until terminal.
- **Get Vendor**: Get one vendor's exact price, per-call ceiling, required input fields (body vs query), reliability and an example. Public, free.
- **List Agent Keys**: List every agent key on the account, revoked ones included, with its sub-account and last use. Never the key string.
- **List Capabilities**: List the catalog's capability groups and categories, with vendor counts and price ranges. Public, free.
- **List Purchased Resources**: List durable things bought through paid calls (gift cards, inboxes, videos) with delivery status. Never the goods themselves.
- **List Sub-Accounts**: List every budget (sub-account) on the account with each window's cap, spend, remaining headroom and category rules.
- **List Transactions**: List the money history newest first, filterable by kind, status, ledger state, sub-account, vendor, capability and date.
- **Pay Vendor**: Pay one named catalog vendor per call and get its answer back. Spends money from the agent key's budget.
- **Read Follow-Up Artifact**: Read a paid vendor's free wallet-gated companion artifact (call transcript, async lookup status). Moves no money.
- **Revoke Account Key**: Revoke the account key. Agent keys it minted keep working; a new account key must be minted in the dashboard.
- **Revoke Agent Key**: Revoke one agent key. It stops authenticating on the very next request; spent money is not reversed.
- **Run Task**: Describe a job in plain English; Perflo picks the vendor, builds the request, pays and fails over. Spends money. Long runs return a task id to poll.
- **Search Vendors**: Find payable vendors from a plain-English description of the work, ranked best first with price and per-call ceiling. Free.
- **Search Vendors (Query String)**: Same ranked vendor search as POST /v1/search, driven from the query string. Free.
- **Send Transfer**: Send USDC or USDT from the account's own on-chain funds to an address. Spends money under the spending policy.
- **Set Spending Policy**: Create the account-wide spending policy or change its hourly/daily/monthly caps, expiry and transfer recipient allowlist.
- **Stop Spending**: The off switch: the account key stops all spending on the account; an agent key stops only itself.
- **Update Sub-Account**: Change a budget's label, window caps, category rules, or re-enable/disable it. Limits are replaced, not merged.

## Triggers (2)

- **Transaction completed in Perflo**: Triggers when a Perflo payment, credit or refund reaches its final status. An account key sees every sub-account; an agent key only its own.
- **Payment failed in Perflo**: Triggers when a paid Perflo call ends failed. An account key sees every sub-account; an agent key only its own.

Connect Perflo in General Input: https://www.generalinput.com/apps/perflo