Chrome River API
Chrome River is enterprise expense and invoice management software (by Emburse) used to capture receipts, build expense reports, reconcile corporate cards, route approvals, and process AP invoices with policy controls and ERP exports. An unofficial API lets you programmatically pull u
What is Chrome River?
Chrome River is a cloud platform for travel and expense (T&E) and AP invoice automation. Finance teams use Chrome River to capture receipts via mobile, import corporate card transactions, build and submit expense reports, enforce policy with automated rules, route approvals, and post reimbursable and non-reimbursable spend to their ERP. AP teams use Chrome River to ingest invoices, perform OCR/data capture, match to POs, code lines, orchestrate multi-level approvals, and release for payment.
Core product areas include:
- Expense Management (Expense Reports, Line Items, Categories, Per Diem, Mileage, Attendees, Receipts, Policy Enforcement, Reimbursements)
- Corporate Card & Travel (Card Transaction Feeds, Card Program Management, E-Receipts, Travel Booking Connectors)
- AP Automation (Invoice Capture/OCR, PO/3-Way Matching, Coding, Approvals, Suppliers/Vendors, Payments Files)
- Controls & Compliance (Approval Workflows, Delegation, Audit, VAT/GST Handling, Tax Codes, Export/Posting Rules)
- Analytics & Administration (Dashboards, Data Exports, Roles/Permissions, Cost Centers, Projects, GL Accounts)
Common data entities:
- Employees/Users, Roles/Approvers, Delegates
- Expense Reports (headers, statuses, approval routes)
- Expense Lines (date, category, merchant, amount, tax/VAT, allocations, attendees, mileage/per diem)
- Receipts/Documents (images, PDFs, e-receipts)
- Corporate Card Transactions (auth/posted dates, MCC, merchant, amounts, match status)
- Invoices (header, vendor/supplier, lines, PO references, taxes, payments)
- Vendors/Suppliers, Purchase Orders, Projects/Jobs, Cost Centers/Departments, GL Accounts, Tax Codes
- Approvals & Policy Violations (states, comments, audit trail)
The Chrome River Integration Challenge
Finance teams rely on Chrome River every day, but turning portal-based workflows into API-driven automation is non-trivial:
- API availability and cost: Many tenants rely on scheduled flat-file/SFTP exports; real-time APIs can be add-ons, rate-limited, or inconsistently documented. Receipt and invoice image retrieval is often cumbersome.
- Complex, policy-based workflows: Dynamic routing, conditional approvals, exceptions, and return/resubmit loops make status modeling and idempotency tricky.
- Global tax and currency: VAT/GST codes, reclaim eligibility, multi-currency, and multi-ledger posting rules require careful normalization.
- Identity & SSO: Okta/Azure AD SSO and MFA complicate headless automation and session lifecycles.
- Data spread: Expense lines, card transactions, invoices, and coding live across multiple views and exports; linking them reliably is challenging.
How Supergood Creates Chrome River APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Chrome River tenant.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes responses so you can integrate once and rely on consistent objects across modules
- Aligns with customer entitlements and role-based permissions to ensure compliant access
- Supports large file handling for receipts and invoice PDFs with secure, time-limited URLs
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened Chrome River adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Chrome River evolves.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
Authentication
/sessions/refreshRefresh an existing token to keep sessions uninterrupted.
Expense Reports
/expense-reportsList expense reports with filters and summary details.
Expenses
/expense-reports/{reportId}/expensesAdd an expense line to a report with category, merchant, taxes, allocations, and receipt attachments.
Corporate Card Transactions
/corporate-cards/transactionsList corporate card transactions with match/assignment status.
Invoices
/invoicesCreate an AP invoice with coded lines, tax, and optional PO references.
Use Cases
Expense & Employee Data Sync
- Mirror employees, approvers, expense reports, and policy states into your internal systems - Keep report headers and line-level allocations current for analytics and audit - Normalize cost centers, projects, GL accounts, and tax codes across entities
Card Reconciliation & Receipt Automation
- Pull corporate card transactions daily and auto-match to expenses based on merchant, amount, and date - Attach receipts programmatically from your capture pipeline and flag missing documentation - Surface policy exceptions (e.g., unassigned card charges) and drive reminders
Invoice Automation & ERP Sync
- Create invoices with PO references and coded line items directly from procurement flows - Track match status and approvals, then export to ERP for payment - Normalize vendor master data and GL mappings for multi-entity operations
Analytics & Compliance
- Build near real-time spend dashboards for FP&A and budget owners - Monitor policy violations, audit outcomes, and approval SLAs - Reconcile T&E vs. AP spend, VAT reclaim opportunities, and card program usage
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
Response format
JSON with consistent resource schemas and pagination across modules
Rate limits
Tuned for enterprise throughput while honoring customer entitlements and usage controls
Session management
Automatic reauth and cookie/session rotation with health checks
Data freshness
Near real-time retrieval of expense reports, card transactions, invoices, and approvals
Security
Encrypted transport, scoped tokens, and audit logging; respects Chrome River role-based permissions
Webhooks
Optional asynchronous delivery for long-running workflows (e.g., approvals, invoice match updates)
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume expense report sync, card reconciliation, and invoice processing
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions
Adaptation
Continuous monitoring for UI/API changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across commonly used modules such as Expense Management (Reports, Lines, Receipts), Corporate Cards (Transaction Feeds, Matching), and AP Automation (Invoices, PO Matching, Approvals), subject to your licensing and entitlements. We scope coverage during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Yes. We can normalize invoices, expense reports, and line-item coding to match your ERP/accounting schema (e.g., NetSuite, SAP, QuickBooks, Xero) and deliver updates via webhooks or polling while complying with rate and permission constraints.
Yes. We provide secure, time-limited URLs for downloading images/PDFs and support uploading attachments via signed uploads with checksum validation. We also model receipt status (missing, attached, e-receipt) in normalized responses.