# Find transactions (fast search)

Gets a list of transactions based on specific search parameters within a few seconds. This is an alternative to the Find transactions API call that returns data in JSON, CSV, or XLS format.


  NoticeThis API call does not contain the project_id path parameter, so you need to use the API key that is valid in all the company’s projects to set up authorization.

Endpoint: GET /merchants/{merchant_id}/reports/transactions/simple_search
Version: 2.0
Security: basicAuth

## Path parameters:

  - `merchant_id` (integer, required)
    Merchant ID.

## Query parameters:

  - `transaction_id` (integer)
    Transaction ID. Either this or external_id must be provided, but not both.

  - `external_id` (string)
    Transaction ID in the game. It is unique for each payment. Either this or transaction_id must be provided, but not both.

## Response 200 fields (application/json):

  - `user` (object)
    User details.

  - `user.id` (string)
    User ID.

  - `user.name` (string)
    User name.

  - `user.email` (string)
    User email.

  - `user.country` (string)
    Two-letter uppercase country code per [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `transaction` (object)
    Transaction details.

  - `transaction.project` (object)

  - `transaction.project.id` (integer)
    Project ID. Can be found in Publisher Account.

  - `transaction.project.name` (string)
    Project name.

  - `transaction.id` (integer)
    Transaction ID.

  - `transaction.external_id` (string)
    Transaction ID in the game. It is unique for each user payment.

  - `transaction.status` (string)
    Enum: "created", "processing", "review", "error", "done", "awaitingRefund", "refunded", "canceled", "partiallyRefunded"

  - `transaction.payment_date` (string)
    Date of the payment in YY-MM-DD format.

  - `transaction.refund_reason` (string)
    Refund reason.

  - `payment_details` (object)
    Payment details.

  - `payment_details.payment` (object)

  - `payment_details.payment.amount` (number)
    Payment amount.

  - `payment_details.payment.currency` (string)
    Payment currency. Three-letter currency code per [ISO 4217](https://developers.xsolla.com/doc/pay-station/references/supported-currencies/).


## Response 403 fields

## Response 404 fields

## Response 422 fields