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 e
What is Coast Fuel Card?
Coast Fuel Card 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/ 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 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
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.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP). Returns a short-lived auth token maintained by the platform.
Authentication
/sessions/refreshRefresh an existing token to keep sessions uninterrupted.
Transactions
/transactionsList authorized, settled, or declined transactions with filters and Level-3 fuel details when available.
Drivers
/driversCreate a driver profile and optional default vehicle assignment and PIN.
Card Controls
/cards/{cardId}/controlsUpdate spend controls, MCC restrictions, limits, and time windows for a card.
Receipts
/transactions/{transactionId}/receiptsUpload a receipt image and optional metadata (e.g., odometer, tax breakdown) to a transaction.
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
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP); 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)
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
Frequently asked questions
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.
We support username/password + MFA (SMS, email, TOTP). Sessions are refreshed automatically with secure challenge handling.
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.
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.