Supergood | Airbase API
Programmatically access Airbase spend data, vendors, bills, cards, reimbursements, approvals, and accounting workflows with a stable REST API. Supergood builds and operates production-grade, unofficial Airbase integrations so your team can automate AP and expense operations without heavy custom engineering.
Plain English: Airbase is spend management software for finance teams to control and automate corporate cards, vendor bills/AP, employee reimbursements, approvals, and accounting sync. An unofficial API lets you programmatically pull vendors, cards and transactions, bills and approvals, reimbursements, budgets, and GL coding—and push new records or updates back into Airbase.
For a tech company integrating with Airbase, this means you can ingest real-time spend and vendor data to power dashboards, push purchase requests and bills from procurement, issue virtual cards with policy controls from your product, automate reimbursements, and sync coding to accounting (e.g., QuickBooks, Xero, NetSuite). You can trigger approval workflows, attach receipts, update GL/department/project coding, enforce budgets, and keep stakeholder systems (ERP, analytics, procurement, IT) in lockstep.
What is Airbase?
Airbase (https://www.airbase.com/) is a cloud platform for corporate spend management that unifies AP automation, corporate cards, reimbursements, approvals, and accounting sync for finance teams. Companies use Airbase to manage vendors and bills, issue and control physical/virtual cards, route purchase and payment approvals, capture receipts, reimburse employees, and push clean, coded entries to their accounting system.
Core product areas include:
- Spend Controls & Corporate Cards (virtual and physical, merchant/category restrictions, spend limits)
- AP Automation (vendor management, bills/invoices, payments, PO/purchase requests)
- Employee Reimbursements (policy checks, receipt capture, approvals)
- Approvals & Workflows (multi-step, role-based routing, audit trails)
- Accounting Sync (GL accounts, departments/projects, tax codes, multi-entity/currency)
Common data entities:
- Companies, Users, Roles/Permissions (Finance Admin, Cardholder, Approver, Employee)
- Vendors (profiles, payment terms, banking details)
- Bills/Invoices (line items, taxes, approvals, payments)
- Cards & Transactions (limits, MCC restrictions, budgets, receipts)
- Expenses/Reimbursements (policy flags, coding, payout status)
- Purchase Requests & Approvals (requester, approvers, status)
- Budgets, Departments, Projects (cost centers, allocations)
- GL Accounts & Tax Codes (accounting categories)
- Attachments & Receipts (files, OCR data, audit trails)
The Airbase Integration Challenge
Finance teams rely on Airbase daily, but turning portal-first workflows into API-driven automation is non-trivial:
- Role-aware approvals: Requesters, approvers, finance, and cardholders see different steps, limits, and policy outcomes
- Financial rigor: GL coding, departments/projects, tax handling, and multi-entity/multi-currency require careful normalization
- Card-specific controls: MCC/category restrictions, per-transaction/monthly limits, and merchant rules complicate issuance flows
- Receipt and audit requirements: Attachments, compliance flags, and exception logging demand robust handling
- API access: Teams report limited official API coverage, tier-gated access, and data export friction for automation use cases
- Authentication complexity: SSO/MFA and session lifecycles complicate headless workflows for bots and services
- Data spread: Key objects span vendors, bills, cards, reimbursements, and approvals with context across multiple views
How Supergood Creates Airbase APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Airbase 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
Use Cases
AP & Vendor Automation
- Mirror vendors and bills into your internal systems
- Create vendor bills from procurement or intake workflows
- Attach quotes/invoices and route approvals programmatically
Cards & Spend Controls
- Issue virtual cards with policy rules from your product
- Update limits and MCC restrictions dynamically based on risk signals
- Ingest transactions and receipts for real-time monitoring and alerts
Reimbursements & Policy Enforcement
- Sync employee expenses and receipt status to analytics
- Flag exceptions (missing receipts, over-policy) and route for review
- Update GL/department/project coding and reimbursement status
Accounting Sync & Reporting
- Normalize GL accounts, tax codes, and departments
- Push coded transactions to accounting (e.g., QuickBooks, Xero, NetSuite)
- Generate budget and spend dashboards across entities and currencies
Available Endpoints
Authentication
POST /sessions: Establish 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.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/sessions \
--header 'Authorization: Basic <Base64 encoded token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "[email protected]",
"password": "<password>",
"mfa": { "type": "totp", "code": "123456" }
}'
Example response
{
"authToken": "eyJhbGciOi...",
"expiresIn": 3600,
"user": {
"id": "u_air_19a2e1",
"name": "AP Administrator",
"entitlements": ["vendors", "bills", "cards", "transactions", "reimbursements", "approvals"]
}
}
POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.
Vendors
GET /vendors: List vendors with filters and summary details.
Query parameters
- status: active | inactive | blocked
- name: string (substring match)
- updatedFrom, updatedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"vendorId": "ven_4b21f8",
"name": "Acme Supplies LLC",
"email": "[email protected]",
"taxId": "94-1234567",
"status": "active",
"defaultPaymentMethod": "ach",
"paymentTermsDays": 30,
"currency": "USD",
"address": {
"line1": "500 Market St",
"city": "San Francisco",
"region": "CA",
"postalCode": "94105",
"country": "US"
},
"createdAt": "2026-01-10T08:12:30Z",
"updatedAt": "2026-01-20T14:55:10Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Bills
POST /bills: Create a vendor bill/invoice with line items, taxes, attachments, and approval metadata.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/bills \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"entityId": "ent_us_parent",
"vendorId": "ven_4b21f8",
"invoiceNumber": "INV-2026-1042",
"invoiceDate": "2026-01-19",
"dueDate": "2026-02-18",
"currency": "USD",
"lineItems": [
{"glAccountId": "gl_6100", "departmentId": "dept_marketing", "projectId": null, "description": "Print materials", "quantity": 1, "unit": "lot", "unitPrice": 2500.00, "taxCode": "CA-STD"},
{"glAccountId": "gl_6110", "departmentId": "dept_marketing", "projectId": "proj_launch_q1", "description": "Event sponsorship", "quantity": 1, "unit": "lot", "unitPrice": 5000.00, "taxCode": null}
],
"attachments": [
{"fileName": "invoice_acme.pdf", "uploadToken": "upl_0c92a3"}
],
"requestedByUserId": "u_air_19a2e1",
"notes": "Use early payment discount if available",
"autoPay": false
}'
Example response
{
"billId": "bill_78c3d1",
"status": "awaiting_approval",
"subtotal": 7500.00,
"taxTotal": 187.50,
"total": 7687.50,
"currency": "USD",
"dueDate": "2026-02-18",
"approvals": [
{"step": 1, "role": "department_manager", "status": "pending"},
{"step": 2, "role": "finance", "status": "pending"}
],
"createdAt": "2026-01-21T10:03:11Z"
}
Virtual Cards
POST /cards/virtual: Issue a virtual card with spend limits, MCC restrictions, and budget controls.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/cards/virtual \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"cardholderId": "u_air_7f2d90",
"budgetId": "budg_growth_marketing",
"currency": "USD",
"limitType": "monthly",
"spendLimit": 3000.00,
"perTransactionLimit": 1000.00,
"mccWhitelist": ["4816", "5734"],
"merchantNameAllowlist": ["Zoom", "Canva"],
"expireAt": "2026-12-31T23:59:59Z",
"notes": "Q1 growth tools"
}'
Example response
{
"cardId": "card_v_9a41b2",
"brand": "Visa",
"maskedPan": "4111********1111",
"last4": "1111",
"status": "active",
"limitType": "monthly",
"spendLimit": 3000.00,
"perTransactionLimit": 1000.00,
"budgetId": "budg_growth_marketing",
"createdAt": "2026-01-21T11:20:44Z"
}
Expenses
PATCH /expenses/{expenseId}: Update expense coding, attach receipts, and manage reimbursement state.
curl --request PATCH \
--url https://api.supergood.ai/integrations/<integration_id>/expenses/exp_51af80 \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"glAccountId": "gl_6000",
"departmentId": "dept_sales",
"projectId": null,
"taxCode": "US-NON",
"memo": "Client lunch",
"receipt": {"fileName": "receipt_jan21.jpg", "uploadToken": "upl_7fa223"},
"policyException": {"hasException": true, "reason": "Over per diem"},
"reimbursementStatus": "ready_for_payment"
}'
Example response
{
"expenseId": "exp_51af80",
"status": "coded",
"receiptStatus": "attached",
"coding": {
"glAccountId": "gl_6000",
"departmentId": "dept_sales",
"projectId": null,
"taxCode": "US-NON"
},
"complianceFlags": ["policy_exception"],
"reimbursementStatus": "ready_for_payment",
"updatedAt": "2026-01-22T08:15:12Z"
}
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 vendors, bills, cards/transactions, reimbursements, and approvals
- Security: Encrypted transport, scoped tokens, and audit logging; respects Airbase role-based permissions and approval visibility
- Webhooks: Optional asynchronous delivery for long-running workflows (e.g., approvals, reimbursements, card transactions)
Performance Characteristics
- Latency: Sub-second responses for list/detail queries under normal load
- Throughput: Designed for high-volume vendor/bill sync and card transaction ingestion
- Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
- Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates
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 Airbase adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Airbase evolves.
Frequently Asked Questions
Q: Which Airbase modules can this integration cover?
Supergood supports workflows across commonly used modules such as AP Automation (Vendors, Bills, Payments), Spend Controls (Cards, Transactions), Reimbursements (Expenses, Receipts), and Approvals/Accounting Sync (GL Accounts, Departments/Projects), subject to your licensing and entitlements. We scope coverage during integration assessment.
Q: How are MFA and SSO handled for automation?
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Q: Can you sync bills and expenses to our accounting system?
Yes. We can normalize GL, departments/projects, tax codes, and line items to match your ERP/accounting schema and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with QuickBooks, Xero, and NetSuite.
Q: Do you support virtual card issuance and policy controls?
Yes. We can issue virtual cards, set spend limits, MCC/merchant restrictions, and budget ties, then ingest transactions and receipts for monitoring and coding.
Related Integrations
Intralinks API - Programmatically access the Intralinks VDR with Supergood
Ready to automate your Airbase workflows?
Supergood can have your Airbase integration live in days with no ongoing engineering maintenance.
