# Get transaction reward detail

Returns the reward outcome for one settled transaction. Use this to investigate a cardholder or support question.

Endpoint: GET /api/v2/chg/{chgId}/transaction/{txnId}/reward-detail
Version: current
Security: IssuerApiToken

## Path parameters:

  - `chgId` (string, required)
    Path parameter for the cardholder group (CHG) id. The id uses the chg_ prefix. Format: chg_.
    Example: "chg_22222222-2222-4222-8222-222222222222"

  - `txnId` (string, required)
    Path parameter for the settled transaction event id. The id uses the txn_ prefix. Format: txn_.
    Example: "txn_88888888-8888-4888-8888-888888888888"

## Response 200 fields (application/json):

  - `transactionId` (string, required)
    Percents typed id for the settled transaction event. The id uses the txn_ prefix. Format: txn_.
    Example: "txn_88888888-8888-4888-8888-888888888888"

  - `status` (string, required)
    Reward processing status for the settled transaction event.
    Enum: "matched", "not_matched", "pending", "reversed", "unknown"

  - `merchantId` (string)
    Percents typed id for the matched merchant partner, when one was matched. Format: mp_.
    Example: "mp_55555555-5555-4555-8555-555555555555"

  - `earnedAmountMinor` (integer, required)
    Reward amount earned by this transaction, in minor currency units.
    Example: 1250

  - `spentAmountMinor` (integer, required)
    Branded balance amount spent by this transaction, in minor currency units.
    Example: 1250

  - `clawedBackAmountMinor` (integer, required)
    Reward amount clawed back for this transaction, in minor currency units.
    Example: 1250

  - `currency` (string)
    Currency for the reward amounts, when rewards are present. Currently usd.
    Enum: "usd"

  - `rewardEventIds` (array, required)
    Reward event ids associated with this transaction.
    Example: ["brevt_99999999-9999-4999-8999-999999999999"]

## Response 400 fields (application/json):

  - `code` (integer, required)
    Stable error class code. Use this for durable error handling.
    Example: 1

  - `httpStatusCode` (integer, required)
    HTTP status code associated with the error response.
    Example: 1

  - `uuid` (string, required)
    Unique public error instance id. The id uses the err_ prefix and can be sent to Percents support. Format: err_.
    Example: "err_aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"

  - `message` (string, required)
    Public human-readable error message. Do not parse this field for workflow decisions.

  - `name` (string)
    Optional public error name.

  - `reasonCode` (string)
    Optional machine-readable reason within the error class.

  - `details` (object)
    Optional public structured context for the error. Private diagnostics are not exposed.