> ## Documentation Index > Fetch the complete documentation index at: https://docs.nexusfeed.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get Fuel Surcharge > Return LTL fuel surcharge rates for one or more carriers. Use this endpoint to get the current fuel surcharge percentage applied to LTL freight invoices. Each rate includes the DOE diesel price that triggered it and a `_verifiability` block with extraction timestamp and confidence score. Always check `_verifiability.extraction_confidence >= 0.90` before using in a cost calculation or invoice audit. Typical use cases: - Verify a carrier's fuel surcharge on a freight invoice - Compare surcharge rates across carriers before booking a shipment - Pull 4–26 weeks of history for trend analysis or dispute resolution ## OpenAPI ````yaml https://api.nexusfeed.dev/openapi.json get /v1/ltl/fuel-surcharge openapi: 3.1.0 info: title: B2B Agentic Arbitrage Hub description: >- Real-time LTL freight carrier fuel surcharge rates and ABC liquor license compliance records, served as agent-ready JSON with verifiability metadata. Built for AI agents that need authoritative B2B data — not raw HTML scraping. ## Products - **LTL Fuel Surcharge** (`/v1/ltl`): 6 carriers (ODFL, Saia, Estes, ABF, R+L, TForce), weekly rates, DOE diesel price, up to 5 years of history - **ABC License Compliance** (`/v1/abc`): CA, TX, NY, FL — license status, expiration, and suspension records ## Authentication All endpoints require an `X-API-Key` header. Contact `ops@nexusfeed.dev` to obtain an API key. ## Verifiability Every response includes a `_verifiability` block with `source_timestamp`, `extraction_confidence`, `raw_data_evidence_url`, `extraction_method`, and `data_freshness_ttl_seconds` — enabling agents to cite provenance and assess staleness. version: 1.0.0 servers: - url: https://api.nexusfeed.dev description: Production security: - ApiKeyAuth: [] paths: /v1/ltl/fuel-surcharge: get: tags: - LTL summary: Get Fuel Surcharge description: >- Return LTL fuel surcharge rates for one or more carriers. Use this endpoint to get the current fuel surcharge percentage applied to LTL freight invoices. Each rate includes the DOE diesel price that triggered it and a `_verifiability` block with extraction timestamp and confidence score. Always check `_verifiability.extraction_confidence >= 0.90` before using in a cost calculation or invoice audit. Typical use cases: - Verify a carrier's fuel surcharge on a freight invoice - Compare surcharge rates across carriers before booking a shipment - Pull 4–26 weeks of history for trend analysis or dispute resolution operationId: get_fuel_surcharge_v1_ltl_fuel_surcharge_get parameters: - name: carriers in: query required: false schema: type: array items: $ref: '#/components/schemas/CarrierCode' description: >- One or more carrier SCAC codes (e.g. ODFL, SAIA, ESTES). Defaults to all carriers. Call /v1/ltl/carriers to list valid codes. default: - ODFL - SAIA - ESTES - ABF - RLC - TFORCE - XPO - SEFL - AVERITT - FEDEX title: Carriers description: >- One or more carrier SCAC codes (e.g. ODFL, SAIA, ESTES). Defaults to all carriers. Call /v1/ltl/carriers to list valid codes. - name: weeks in: query required: false schema: type: integer maximum: 26 minimum: 1 description: >- Number of weeks of history to return (1–26). Use 1 for the current rate only. Use 4 for a monthly audit window. default: 4 title: Weeks description: >- Number of weeks of history to return (1–26). Use 1 for the current rate only. Use 4 for a monthly audit window. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/FuelSurchargeResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: CarrierCode: type: string enum: - ODFL - SAIA - ESTES - ABF - RLC - TFORCE - XPO - SEFL - AVERITT - FEDEX title: CarrierCode FuelSurchargeResponse: properties: carrier: $ref: '#/components/schemas/CarrierCode' weeks: items: $ref: '#/components/schemas/FuelSurchargeWeek' type: array title: Weeks _verifiability: $ref: '#/components/schemas/Verifiability' type: object required: - carrier - weeks - _verifiability title: FuelSurchargeResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError FuelSurchargeWeek: properties: effective_date: type: string format: date title: Effective Date fuel_surcharge_pct: type: number title: Fuel Surcharge Pct doe_diesel_price_usd: anyOf: - type: number - type: 'null' title: Doe Diesel Price Usd type: object required: - effective_date - fuel_surcharge_pct title: FuelSurchargeWeek Verifiability: properties: source_timestamp: type: string format: date-time title: Source Timestamp extraction_confidence: type: number title: Extraction Confidence raw_data_evidence_url: type: string title: Raw Data Evidence Url extraction_method: $ref: '#/components/schemas/ExtractionMethod' data_freshness_ttl_seconds: type: integer title: Data Freshness Ttl Seconds type: object required: - source_timestamp - extraction_confidence - raw_data_evidence_url - extraction_method - data_freshness_ttl_seconds title: Verifiability ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError ExtractionMethod: type: string enum: - api_mirror - playwright_dom - structured_parse - scraper_api - scraper_api_fallback title: ExtractionMethod securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````