# Transaction Token

## Definition
- **transaction_token** (`uuid`, required): The token of the transaction that the enhanced data is associated with.

## Response Structure
### 200 - Fraud report for the specified transaction.

- **transaction_token** (`uuid`, required): The universally unique identifier (UUID) associated with the transaction being reported.
- **fraud_status** (`string`, enum, required): The fraud status of the transaction, supporting the following values:
  - `SUSPECTED_FRAUD`: The transaction is suspected to be fraudulent, but this hasn’t been confirmed.
  - `FRAUDULENT`: The transaction is confirmed to be fraudulent.
  - `NOT_FRAUDULENT`: The transaction is marked as not fraudulent.
  - `NO_REPORTED_FRAUD`: Indicates that no fraud report exists for the transaction.
- **fraud_type** (`string`, enum): Specifies the type or category of fraud, supporting:
  - `FIRST_PARTY_FRAUD`
  - `ACCOUNT_TAKEOVER`
  - `CARD_COMPROMISED`
  - `IDENTITY_THEFT`
  - `CARDHOLDER_MANIPULATION`
- **comment** (`string`): Provides additional context about the fraud report.
- **created_at** (`date-time`): Timestamp of when the fraud report was created.
- **updated_at** (`date-time`): Timestamp of the last update to the fraud report.

## Error Responses
### 400 - Bad Request
- A parameter in the query does not match the valid queries for the endpoint.

### 401 - Unauthorized
- User has not been authenticated, invalid or missing API key, etc.

### 404 - Not Found
- The specified resource was not found.

### 422 - Unprocessable Entity
### 429 - Too Many Requests
- Client has exceeded the number of allowed requests in a given time period.

## Example Request
```shell
curl --request GET \
     --url https://sandbox.lithic.com/v1/fraud/transactions/transaction_token \
     --header 'accept: application/json'
```

## Example Response
```json
{
  "transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "fraud_status": "SUSPECTED_FRAUD",
  "fraud_type": "FIRST_PARTY_FRAUD",
  "comment": "string",
  "created_at": "2026-07-18T00:25:39.405Z",
  "updated_at": "2026-07-18T00:25:39.405Z"
}
```
