Supergood | Coast Fuel Card API
Programmatically access Coast fuel and fleet expense data—cards, drivers, vehicles, transactions, receipts, and controls—with a stable REST API. Supergood builds and operates production-grade, unofficial Coast integrations so your team can automate fleet finance and operations without heavy custom engineering.
Plain English: Coast Fuel Card is a modern Visa-powered fleet and fuel card with a web console to control spend, assign cards to drivers/vehicles, and reconcile fuel and maintenance purchases. An unofficial API lets you pull real-time authorizations and settled transactions (including gallons, unit price, odometer), drivers, vehicles, cards, and statements—and push updates like new drivers, policy changes, receipt attachments, and accounting tags.
For a tech company integrating with Coast, this means you can ingest transaction streams to power fleet dashboards and anomaly detection, sync GL codes and classes to accounting (e.g., QuickBooks, Xero), automate card controls from your platform (limits, MCC restrictions), create or suspend cards when HR or telematics systems change, attach receipts from your mobile app, and keep TMS/ERP/analytics stacks in lockstep with spend and usage.
What is Coast Fuel Card?
Coast Fuel Card (https://coastpay.com/) provides a fleet expense platform and fuel/maintenance card accepted anywhere Visa is accepted, with granular controls to manage spend by driver, vehicle, merchant category, location, and time. Teams use Coast to issue and manage cards, set policies, receive real-time alerts, capture receipts and odometer readings, and close the books with statements and exports.
Core product areas include:
- Card & Spend Controls (MCC/category restrictions, per-transaction/day/week limits, merchant allowlists, card lock/unlock)
- Fleet Directory (Drivers, Vehicles, Assignments, PINs)
- Transactions & Receipts (Authorizations, Settlements, Gallons, Unit Prices, Odometer, Attachments)
- Accounting & Reporting (GL coding/tags, Statements, Exports to CSV/Accounting, Taxes)
- Risk & Compliance (Real-time alerts, Declines, Fraud Flags, Location data)
- Administration (Users/Roles, Permissions, Audit Logs)
Common data entities:
- Companies, Users, Roles/Permissions
- Cards (physical/virtual), Card Status & Controls/Policies
- Drivers (identity, contact, PIN), Vehicles (VIN, plate, odometer)
- Transactions (authorized/settled/declined), Merchants (MCC, address)
- Receipts (images, metadata), Odometer Readings
- Statements (cycles, totals, PDFs), Payments
- Tags/GL Codes (departments, cost centers, jobs/projects)
The Coast Integration Challenge
Fleets rely on Coast’s portal for day-to-day spend control and reconciliation, but turning portal-based workflows into API-driven automation is non-trivial:
- Portal-first features: Controls, receipt workflows, and CSV exports are optimized for front-end use; official developer APIs may be limited or not publicly available
- Authentication complexity: MFA/SSO and dynamic session lifecycles complicate headless automation
- Authorization vs. settlement: Data arrives at different times; Level-3 fuel details (gallons, unit price) and taxes can appear post-settlement
- Policy modeling: MCC/category rules, per-period limits, and driver/vehicle assignments require careful normalization
- Role-aware data: Admins, accountants, and fleet managers may see different objects and actions
How Supergood Creates Coast APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Coast 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
Fleet Directory & Card Lifecycle Sync
- Mirror drivers, vehicles, and cards into your internal systems
- Automatically assign/suspend cards based on HR or telematics events
- Keep PINs, assignments, and statuses current for compliance
Policy & Control Automation
- Programmatically update MCC/category restrictions and spend limits
- Enforce consistent controls across regions, cost centers, or vehicle classes
- Trigger geofenced restrictions and time windows for higher-risk spend
Transactions, Receipts, and Accounting Sync
- Stream authorized and settled transactions to your data warehouse
- Attach receipts from your mobile app and capture odometer readings
- Normalize GL accounts, classes, and cost centers; sync to accounting (e.g., QuickBooks, Xero)
Fraud Monitoring & Operations Alerting
- Detect off-hours or out-of-geo purchases and auto-lock cards
- Flag non-fuel spend above thresholds; notify fleet managers instantly
- Correlate transaction locations with telematics data for validation
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_coast_1f2d9a",
"name": "Fleet Admin",
"entitlements": ["cards", "drivers", "vehicles", "transactions", "statements"]
}
}
POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.
Transactions
GET /transactions: List authorized, settled, or declined transactions with filters and Level-3 fuel details when available.
Query parameters
- status: authorized | settled | declined
- type: fuel | maintenance | non_fuel
- driverId, vehicleId, cardId: string
- mcc: string (Visa MCC)
- authorizedFrom, authorizedTo: ISO 8601 timestamps
- postedFrom, postedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"transactionId": "txn_7c21a0",
"authId": "auth_5b9821",
"status": "settled",
"type": "fuel",
"amount": 92.47,
"currency": "USD",
"authorizedAt": "2026-01-20T14:23:11Z",
"postedAt": "2026-01-21T03:10:05Z",
"cardId": "card_flt_9132",
"driver": { "driverId": "drv_aa12f3", "name": "J. Martinez" },
"vehicle": { "vehicleId": "veh_f150_2021", "label": "Truck 12" },
"merchant": {
"name": "ACME Fuel #104",
"mcc": "5541",
"address": { "city": "Phoenix", "region": "AZ", "country": "US" },
"location": { "lat": 33.4484, "lon": -112.0740 }
},
"fuel": {
"gallons": 21.36,
"unitPrice": 4.12,
"fuelGrade": "unleaded",
"productCode": "UNL87"
},
"odometer": { "value": 84213, "unit": "mi" },
"taxAmount": 6.75,
"receipt": { "status": "attached", "fileIds": ["file_9c113a"] },
"tags": { "glAccount": "6420-Fuel", "costCenter": "West-Region", "jobCode": "PRJ-2041" },
"riskFlags": ["out_of_hours"],
"updatedAt": "2026-01-21T03:10:06Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Drivers
POST /drivers: Create a driver profile and optional default vehicle assignment and PIN.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/drivers \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"externalId": "HR-DRV-9211",
"firstName": "Ariana",
"lastName": "Nguyen",
"email": "[email protected]",
"phone": "+15555550112",
"pin": "4281",
"status": "active",
"defaultVehicleId": "veh_f150_2021",
"tags": { "region": "West", "division": "Construction" }
}'
Example response
{
"driverId": "drv_b9f321",
"createdAt": "2026-01-21T10:03:11Z"
}
Card Controls
PATCH /cards/{cardId}/controls: Update spend controls, MCC restrictions, limits, and time windows for a card.
curl --request PATCH \
--url https://api.supergood.ai/integrations/<integration_id>/cards/card_flt_9132/controls \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"status": "active",
"fuelOnly": true,
"allowedMccGroups": ["fuel", "maintenance"],
"merchantAllowlist": ["ACME Fuel #104", "Speedy Lube #22"],
"limits": {
"perTransaction": 150.00,
"perDay": 400.00,
"perWeek": 1200.00
},
"timeWindows": [
{ "days": ["mon","tue","wed","thu","fri"], "start": "06:00", "end": "20:00", "tz": "America/Phoenix" }
],
"geoFence": { "type": "radius", "lat": 33.4484, "lon": -112.0740, "meters": 50000 }
}'
Example response
{
"cardId": "card_flt_9132",
"status": "active",
"controlsVersion": 7,
"updatedAt": "2026-01-22T08:15:12Z"
}
Receipts
POST /transactions/{transactionId}/receipts: Upload a receipt image and optional metadata (e.g., odometer, tax breakdown) to a transaction.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/transactions/txn_7c21a0/receipts \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"fileName": "receipt_2026-01-20.jpg",
"uploadToken": "upl_2bd88f",
"contentType": "image/jpeg",
"odometer": { "value": 84213, "unit": "mi" },
"taxAmount": 6.75,
"notes": "Washed windshield; fuel only"
}'
Example response
{
"receiptId": "rcpt_11d0a9",
"status": "attached",
"createdAt": "2026-01-21T11:20:44Z"
}
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 authorizations, settlements, card controls, and statements; models Level-3 fuel fields when available
- Security: Encrypted transport, scoped tokens, and audit logging; respects Coast role-based permissions
- Webhooks: Optional asynchronous delivery for long-running workflows (e.g., settlement updates, receipt attachments, control changes)
Performance Characteristics
- Latency: Sub-second responses for list/detail queries under normal load
- Throughput: Designed for high-volume transaction ingestion and receipt/control updates
- 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 Coast adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Coast evolves.
Frequently Asked Questions
Q: Which Coast modules can this integration cover?
Supergood supports workflows across Cards & Controls, Drivers & Vehicles, Transactions & Receipts, and Statements/Exports, 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 transactions and statements to our accounting system?
Yes. We normalize transactions (including gallons, unit price, taxes), statements, and tags to your ERP/accounting schema and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with QuickBooks and Xero.
Q: Do you support real-time fuel authorizations and receipt capture?
We can stream near real-time authorizations and then enrich with settlement/Level-3 details when posted. Receipt attachments can be uploaded via signed uploads with checksum validation and time-limited URLs, and linked back to the original transaction.
Related Integrations
Intralinks API - Programmatically access the Intralinks VDR with Supergood
Ready to automate your Coast Fuel Card workflows?
Supergood can have your Coast integration live in days with no ongoing engineering maintenance.
