> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withbenji.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Reward Transaction

> Endpoint to retrieve information regarding a reward transaction

<Note>The `x-api-key` header value to be used on this API is your **partner API key**, which can be generated through the dashboard.</Note>

<ParamField path="id" type="string" required>
  Unique identifier of the reward transaction to retrieve (UUID)
</ParamField>

### Return values

<ResponseField name="reward_transaction" type="object">
  A reward\_transaction object property

  <Expandable title="properties" defaultOpen="true">
    <ResponseField name="id" type="integer">Benji Platform reward transaction identifier</ResponseField>
    <ResponseField name="partner_id" type="integer">The ID of the partner associated with this transaction in the Benji Platform</ResponseField>
    <ResponseField name="partnership_uuid" type="string">The UUID of the partnership associated with this transaction in the Benji Platform</ResponseField>
    <ResponseField name="campaign_id" type="integer">The ID of the campaign triggered for this transaction in the Benji Platform</ResponseField>
    <ResponseField name="user_uuid" type="string">The UUID of the user associated with the transaction in the Benji Platform</ResponseField>
    <ResponseField name="trigger_event_uuid_id" type="string">The UUID of the trigger event associated with the transaction in the Benji Platform</ResponseField>
    <ResponseField name="trigger_event_id" type="integer">The ID of the trigger event associated with the transaction in the Benji Platform</ResponseField>
    <ResponseField name="merchant_id" type="integer">The ID of the merchant partner associated with this campaign in the Benji Platform</ResponseField>
    <ResponseField name="transaction_amount" type="integer">The total dollar amount of the transaction</ResponseField>
    <ResponseField name="reward_amount" type="integer">The total amount of rewards earned or redeemed on this transaction</ResponseField>
    <ResponseField name="external_order_id" type="string">The external reference of the order on the merchant partner system</ResponseField>

    <ResponseField name="transaction_type" type="integer">
      Integer representing an enum of one of the following transaction type values:

      <Expandable title="possible transaction type values" type="enum">
        * **EARN (1)** : Indicating an earn transaction type <br />
        * **REDEEM (2)** : Indicating a redeem transaction type  <br />
      </Expandable>
    </ResponseField>

    <ResponseField name="transaction_status" type="integer">
      Integer representing an enum of one of the following transaction status values:

      <Expandable title="possible transaction status values" type="enum">
        * **INITIATED (1)** : Transaction has been initiated <br />
        * **PENDING (2)** : Transaction is pending and has not been confirmed by the partner yet <br />
        * **COMPLETED (3)** : Transaction has been completed successfully <br />
        * **ERROR (4)** : An error occurred during processing <br />
        * **REVERSED (5)** : Transaction was reversed <br />
        * **FAILED (6)** : Transaction was rejected by the partner <br />
        * **CANCELLED (7)** : Transaction was cancelled <br />
      </Expandable>
    </ResponseField>

    <ResponseField name="created_date" type="datetime">The transaction date</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
      "code": "ok",
      "data": {
          "reward_transaction": {
              "campaign_id": "675976-khkgyt7-9876-khfiy",
              "created_date": "2025-08-18T20:45:01.186277+00:00",
              "external_id": null,
              "external_order_id": null,
              "external_partner_transaction_id": null,
              "id": 5924,
              "merchant_id": 41,
              "partner_id": 5,
              "partnership_uuid": "partnership-uuid",
              "trigger_event_uuid_id": "trigger-event-uuid",
              "trigger_event_id": 12345,
              "reward_amount": 600,
              "transaction_amount": 0.0,
              "transaction_status": 4,
              "transaction_type": 1,
              "user_uuid": "user-uuid"
          }
      }
  }
  ```

  ```json 400 theme={null}
  {
    "code": "invalid_token",
    "message": "Invalid token"
  }
  ```

  ```json 401 theme={null}
  {
    "code": "unauthorized_request",
    "message": "Token is not authorized to make this request"
  }
  ```

  ```json 404 theme={null}
  {
    "code": "transaction_does_not_exist",
    "message": "The transaction does not exist"
  }
  ```
</ResponseExample>

<Tip>Note that you will only receive data that you as a loyalty partner or merchant partner are allowed to see based on the permissions in the access token you provide to the API.</Tip>