Bank Transactions
Read-only access to bank transactions synced via Plaid. Amounts are in cents (positive = money out). Use the categorize action to import a transaction as an expense.
GETList bank transactions
GET/bank-transactions
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default: 1) |
| limit | integer | Items per page, max 100 (default: 20) |
| accountId | string | Filter by Plaid account ID |
| imported | boolean | true | false — filter by import status |
| startDate | date | Transactions on or after YYYY-MM-DD |
| endDate | date | Transactions on or before YYYY-MM-DD |
curl "https://paymavo.com/api/v1/bank-transactions?imported=false&startDate=2026-01-01" \
-H "Authorization: Bearer sk_live_xxx"GETGet a bank transaction
GET/bank-transactions/{id}
curl "https://paymavo.com/api/v1/bank-transactions/txn_abc123" \
-H "Authorization: Bearer sk_live_xxx"POSTImport & categorize a transaction
POST/bank-transactions/{id}/categorize
Imports the transaction as an expense. Returns 200 if already imported, 201 on first import.
| Parameter | Type | Description |
|---|---|---|
| markAsRecurring | boolean | Mark the resulting expense as recurring |
| frequency | string | Recurring frequency: WEEKLY | BIWEEKLY | MONTHLY | QUARTERLY | YEARLY |
curl -X POST "https://paymavo.com/api/v1/bank-transactions/txn_abc123/categorize" \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"markAsRecurring": true, "frequency": "MONTHLY"}'Docs