API Response Structure

200 OK

Response Object

• data: Array of objects
  • Data
    • token (uuid, required): A unique identifier for the enhanced commercial data.
    • transaction_token (uuid, required): The token of the transaction that the enhanced data is associated with.
    • event_token (uuid, required): The token of the event that the enhanced data is associated with.
    • common (object, required): CommonData object
    • fleet: Array of objects, required
      • Fleet
        • service_type (enum): The type of fuel service.
        • odometer (integer | null): The odometer reading entered into the terminal at the time of sale.
        • vehicle_number (string | null): The vehicle number entered into the terminal at the time of sale, with leading zeros stripped.
        • driver_number (string | null): The driver number entered into the terminal at the time of sale, with leading zeros stripped.
        • fuel (object, required): FuelData object
        • amount_totals (object, required): AmountTotals object

Error Responses

400 Bad Request

• A parameter in the query given in the request does not match the valid queries for the endpoint.

401 Unauthorized

• User has not been authenticated
• Invalid or missing API key
• API key is not active
• Could not find API key
• Please provide API key in Authorization header
• Please provide API key in the form Authorization: [api-key]
• Insufficient privileges. Issuing API key required
• Insufficient privileges to create virtual cards.

422 Unprocessable Entity

429 Too Many Requests

• Client has exceeded the number of allowed requests in a given time period.

Example API Call

curl --request GET \
     --url https://sandbox.lithic.com/v1/transactions/transaction_token/enhanced_commercial_data \
     --header 'accept: application/json'

Example Response

{
  "data": [
    {
      "token": "fda41769-2a3f-5532-898f-0d2034f2da85",
      "transaction_token": "6b79924e-0f01-4bdf-9485-9f6da44b6be2",
      "event_token": "49bbd49c-dfe1-56db-86ad-98c7c2bd75e4",
      "common": {
        "customer_reference_number": null,
        "merchant_reference_number": null,
        "order_date": null,
        "line_items": [],
        "tax": {
          "merchant_tax_id": "521236050",
          "amount": null,
          "exempt": null
        }
      },
      "fleet": [
        {
          "service_type": "SELF_SERVICE",
          "driver_number": null,
          "vehicle_number": "012345",
          "odometer": 12345,
          "amount_totals": {
            "gross_sale": 104,
            "discount": null,
            "net_sale": 104
          },
          "fuel": {
            "quantity": "0.24300",
            "type": "PREMIUM_SUPER",
            "unit_of_measure": "GALLONS",
            "unit_price": 4300
          }
        }
      ]
    }
  ]
}