ODFL Bill of Lading API

naftiko: 1.0.0-alpha2
info:
  label: ODFL Bill of Lading API
  description: The Old Dominion Freight Line Bill of Lading API submits electronic bills of lading to the ODFL billing system.
    The service generates shipping labels and BOL documents that can be printed and applied to freight, enabling shippers
    to programmatically create freight documentation as part of their shipping workflow.
  tags:
  - Old
  - Dominion
  - Freight
  - Line
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: old-dominion-freight-line
    baseUri: https://www.odfl.com/wsBOL/v3
    description: ODFL Bill of Lading API HTTP API.
    authentication:
      type: basic
      username: '{{OLD_DOMINION_FREIGHT_LINE_USERNAME}}'
      password: '{{OLD_DOMINION_FREIGHT_LINE_PASSWORD}}'
    resources:
    - name: createbol
      path: /createBOL
      operations:
      - name: createbilloflading
        method: POST
        description: Create an electronic bill of lading
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: old-dominion-freight-line-rest
    description: REST adapter for ODFL Bill of Lading API.
    resources:
    - path: /createBOL
      name: createbilloflading
      operations:
      - method: POST
        name: createbilloflading
        description: Create an electronic bill of lading
        call: old-dominion-freight-line.createbilloflading
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: old-dominion-freight-line-mcp
    transport: http
    description: MCP adapter for ODFL Bill of Lading API for AI agent use.
    tools:
    - name: createbilloflading
      description: Create an electronic bill of lading
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: old-dominion-freight-line.createbilloflading
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    OLD_DOMINION_FREIGHT_LINE_USERNAME: OLD_DOMINION_FREIGHT_LINE_USERNAME
    OLD_DOMINION_FREIGHT_LINE_PASSWORD: OLD_DOMINION_FREIGHT_LINE_PASSWORD