# 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](/content/contact/index.html) | 
| 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
      }
    }
  ]
}
```
