Calculate Fuel Surcharge | Freight Rate Intelligence API

curl -X POST https://freightrateintelligence.com/v1/fuel-surcharge \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "ok": true,
  "data": {
    "region": "Gulf Coast (PADD 3)",
    "equipment": "DRY_VAN",
    "equipment_display": "Dry Van",
    "formula": "PER_MILE",
    "diesel_price": 3.85,
    "diesel_source": "string",
    "diesel_region": "string",
    "diesel_observation_date": "string",
    "primary_result": {
      "value": 1.1,
      "unit": "USD_per_mile",
      "display": "string"
    },
    "per_mile": {
      "fsc_per_mile": 1.1,
      "fsc_total": 1.1,
      "miles": 1.1,
      "baseline": 1.1,
      "mpg_divisor": 1.1,
      "formula_display": "string"
    },
    "percentage": {
      "surcharge_pct": 1.1,
      "surcharge_amount": 1.1,
      "base_freight_charge": 1.1,
      "effective_total": 1.1,
      "formula_display": "string",
      "table_bracket": {
        "diesel_range": "string",
        "surcharge_pct": 1.1,
        "note": "string"
      }
    },
    "consistency_check": {
      "note": "string",
      "per_mile_fsc": 1.1
    },
    "confidence": {
      "level": "HIGH",
      "score": 1.1,
      "label": "string",
      "factors": [
        "string"
      ]
    },
    "model_type": "FUEL_SURCHARGE",
    "model_disclaimer": "string",
    "factor_versions": [
      {
        "source": "EIA",
        "series_id": "PET.EMD_EPD2DXL0_PTE_R30_DPG.W",
        "version": "latest",
        "fetched_at": "2024-01-15T09:30:00Z"
      }
    ]
  },
  "receipt_id": "rcpt_01abc...",
  "auth_obj_id": "auth_01xyz..."
}

Standalone fuel surcharge calculation using the ATA/DOE formula with PADD regional diesel pricing from EIA weekly data. Use case: carriers verifying FSC charges, shippers auditing invoices, fleet managers tracking surcharge trends.

Authentication

AuthorizationBearer

Your Freight Rate Intelligence API key. Get one at freightrateintelligence.com/dashboard/settings

Request

This endpoint expects an object.

originstringOptional

Origin city/state for PADD regional diesel pricing. More accurate than region.

regionenumOptionalDefaults to NATIONAL

PADD region name or number. Used when origin is not provided.

formulaenumOptionalDefaults to PER_MILE

PER_MILE: ATA/DOE standard, returns FSC per mile. Best for FTL. PERCENTAGE: Returns surcharge as % of base freight charge. Best for LTL.

Allowed values:

equipmentenumOptionalDefaults to DRY_VAN

Equipment type affects MPG used in per-mile formula.

milesdoubleOptional

Route miles. Required for per-mile total FSC calculation. Optional for percentage formula.

base_freight_chargedoubleOptional

Total freight charge in USD. Required for percentage formula. Replaces deprecated ‘base_rate’.

baselinedoubleOptionalDefaults to 1.25

Baseline diesel price for ATA/DOE formula. Industry standard is $1.25.

mpg_divisordoubleOptionalDefaults to 6

MPG divisor for ATA/DOE formula. Defaults to equipment MPG (e.g. 6.5 for DRY_VAN).

Response

Fuel surcharge calculation with receipt

okboolean

dataobject

Skill-specific response data

receipt_idstring

auth_obj_idstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error