# Search Clearing Transactions
source: https://developer.mastercard.com/transaction-notifications/documentation/use-cases/search-clearing-transactions/index.md

Use the `/notifications/transactions/search` endpoint to retrieve the final clearing details for a transaction. Clearing data is useful when the settled amount differs from the authorized amount, for example, when a tip is added to a restaurant bill. To match an authorization notification to its clearing record, use the combination of `financialNetworkCode` + `referenceNumber` + `settlementDate`.

## How It Works {#how-it-works}

The following diagram shows the flow for searching clearing transactions:
Diagram searchclearingtransactions

1. Your service sends a `POST /notifications/transactions/search` request to Mastercard with search criteria. The API accepts the following input combinations:

   * **Single transaction lookup** : Provide a `transUid` value from the authorization notification.
   * **Date range for specific cards** : Provide `cardReferences[]` with `transactionStartDate` and `transactionEndDate`.
   * **Transactions after a date** : Provide only `afterTransactionDate`.
   * **Cursor-based retrieval** : Use `clearingCursor` to read all clearing events as they are created. Pass `"0"` in the first call, then use the `nextClearingCursor` value from each response in the next call.

   Note: The API supports pagination using `offset` and `limit` parameters. The `offset` must be a multiple of `limit`. The maximum `limit` is 200.
2. Mastercard looks up clearing records that match the criteria.

3. Mastercard returns the clearing details along with pagination metadata (`count`, `offset`, `total`).

4. Your service reconciles the authorization notification with the settled clearing amount.

Tip: Clearing webhook notifications can be enabled in addition to using this search endpoint. When enabled, Mastercard sends clearing events to your webhook as they become available. The notification payload contains a `clearing` property with a list of clearing records in the same format as the search API response.

## Endpoint Structure {#endpoint-structure}


API Reference: `POST /notifications/transactions/search`

## Next Steps {#next-steps}

* [View the full Open API specification](https://developer.mastercard.com/transaction-notifications/documentation/api-reference/index.md)
* [Review the API's error responses](https://developer.mastercard.com/transaction-notifications/documentation/codes-and-formats/index.md)