Event Token

uuid
required
The token of the transaction event that the enhanced data is associated with.

``200 OK

object
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
customer_reference_number
string | null
A customer identifier.

merchant_reference_number
string | null
A merchant identifier.

order_date
date | null
The date of the order.

tax
object
required
TaxData object

line_items
array of objects
required
Line Items*

object
An L2/L3 enhanced commercial data line item.

product_code
string | null
An identifier for the item purchased.

description
string | null
A human-readable description of the item.

quantity
string | null
The quantity of the item purchased.

amount
string | null
The price of the item purchased in merchant currency.

fleet
array of objects
required
Fleet*

object
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

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

``401

| | | | --- | --- | | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at lithic.com/contact | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege |

``422 Unprocessable entity.

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

| | | | --- | --- | | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

API Example

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

Sample Response

{
  "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
      }
    }
  ]
}