# RefundSearchInput

Input · GraphQL API

Input fields for searching for refunds.

## Fields

- `id` (`SearchValueInput`): Find refunds with an ID or IDs.
- `status` (`SearchTransactionStatusInput`): Find refunds with the given status.
- `statusTransition` (`SearchPaymentStatusTransitionInput`): Find payments based on the time at which they transitioned to a given status.
- `createdAt` (`SearchTimestampInput`): Find refunds based on the time they were created.
- `amount` (`MonetaryAmountSearchInput`): Find refunds with a given amount or currency.
- `orderId` (`SearchTextInput`): Find refunds with a given orderId.
- `merchantAccountId` (`SearchPaymentMerchantAccountIdInput`): Find refunds processed through a merchant account ID or IDs. In most cases, this will be the merchant account of the original refunded transaction.
- `customer` (`SearchPaymentCustomerInput`): Find refunds with a given customer.
- `disbursementDate` (`SearchDateInput`): Find refunds by their disbursement date. Only use this search criteria if you have an eligible merchant account. Note that refunds can only be disbursed after they reach the SETTLED status.
- `source` (`SearchPaymentSourceInput`): Find refunds created with a given source.
- `settlementBatchId` (`SearchTextInput`): Find refunds by the batch ID under which the refund was submitted for settlement.
- `paymentMethod` (`SearchPaymentPaymentMethodInput`): Find refunds based on information about the payment method used for the refund.
- `facilitatorOAuthApplicationClientId` (`SearchValueInput`): Find refunds created by a third party via the Grant API using a given OAuth application client ID.
- `userId` (`SearchValueInput`): Find refunds with a user ID or IDs.
- `storeId` (`SearchValueInput`): Find refunds by the ID of the store that the transaction was processed in.
- `readerId` (`SearchValueInput`): Find refunds by the reader ID.
- `shippingAddress` (`SearchAddressInput`): Find refunds by the shipping address.
- `billingAddress` (`SearchAddressInput`): Find refunds by the billing address.
- `disputeReceivedDate` (`SearchDateInput`): Find refunds by dispute received date.
- `processorAuthorizationId` (`SearchTextInput`): Find refunds by the processor authorization code.
- `processingMode` (`SearchProcessingModeInput`): Find refunds by the processing mode.

## Used by

- [refunds](/braintree/graphql/reference/queries/refunds) — Query; input
- [Search](/braintree/graphql/reference/types/search) — Object; refunds(input)

## GraphQL definition

```graphql
input RefundSearchInput {
  id: SearchValueInput
  status: SearchTransactionStatusInput
  statusTransition: SearchPaymentStatusTransitionInput
  createdAt: SearchTimestampInput
  amount: MonetaryAmountSearchInput
  orderId: SearchTextInput
  merchantAccountId: SearchPaymentMerchantAccountIdInput
  customer: SearchPaymentCustomerInput
  disbursementDate: SearchDateInput
  source: SearchPaymentSourceInput
  settlementBatchId: SearchTextInput
  paymentMethod: SearchPaymentPaymentMethodInput
  facilitatorOAuthApplicationClientId: SearchValueInput
  userId: SearchValueInput
  storeId: SearchValueInput
  readerId: SearchValueInput
  shippingAddress: SearchAddressInput
  billingAddress: SearchAddressInput
  disputeReceivedDate: SearchDateInput
  processorAuthorizationId: SearchTextInput
  processingMode: SearchProcessingModeInput
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)