/api/v1/finance/fees endpoint returns approved, quote-safe dealer-fee and finance-program rows from the finance_fees dataset. Every row returned has quote_safe: true, meaning it has passed verification review and is cleared for use in customer-facing quote calculations. Results are ordered by financier_name then product_title and reflect the most recently verified version of each fee record.
This endpoint requires production access to the
finance_fees dataset. Sandbox-tier keys will receive a 403 response. Request access →Endpoint
Request
Headers
Your API key. Pass the value exactly as shown in your dashboard.
Query Parameters
Filter by trade category. Matched against the
trade_category field (case-insensitive). Accepted values: solar, hvac, roofing, plumbing, electrical.Filter by financier slug (e.g.
goodleap, sunlight_financial). Matched against the financier_slug field.Filter by payment product type. Matched against the
payment_type field (case-insensitive). Common values: loan, lease, ppa, cash.Exact term filter in months (e.g.
120, 180, 240). Must be a valid integer or the request returns a 400 error.Exact interest rate filter as a decimal (e.g.
0.0 for 0% promos). Must be a valid number or the request returns a 400 error.Response
A successful response returns anapplication/json object with a top-level data array of dealer-fee records and a usage block for your request metering.