Performing Searches in the Dashboard

    Use the Dashboard to search for payments, customers, and more.

    You can use the advanced search mechanism available in the Dashboard to look up information about:

    • Connected accounts
    • Coupons
    • Customers
    • Invoices and invoice items
    • Orders
    • Payments
    • Payouts
    • Plans
    • Products
    • Sources
    • Transfers

    When you perform a search, the top results appear immediately and you can view all matches either by clicking Show more results or pressing Enter. You can use different pieces of information as search terms, such as the the last four digits of a card or bank account (e.g., 4242), type of payment method (e.g., ideal), business name of a connected Stripe account (e.g., Rocketship), or email receipt number (e.g., 1817-9523).

    For searches using dates, you can provide them in different formats, such as 11/19, 2019-11-13, or last week. You can also use object identifiers (e.g., a dispute ID) to take you directly to the object you’re looking for.

    No additional context is necessary for most searches. The Dashboard automatically looks for the most relevant information based on your search query. You can make use of search filters and operators for more granular control.

    Search filters and operators

    By default, the Dashboard looks for values that match your search term in the most logical fields within objects (e.g., an email address in the email field or description of an object, or a date as a card expiration date). You can use filters and operators to further refine your searches. The more terms you provide in your search query, the fewer the number of results.

    Use filters to limit your search terms so they only apply to specific fields within applicable objects. Preface a search term with one of these filters. Many fields are shared across different objects. For instance, amount applies to payments, invoices, payouts, etc.

    Search filter Description Example
    amount: The amount of an object. For decimal currencies, use a decimal point for both currency units (e.g., dollars and cents). amount:149.99
    brand: The brand of card associated with an object. brand:visa
    country: The two-letter ISO code representing the country associated with an object. country:GB
    created: The date an object was created (identical to date). created:2017/10/24
    currency: The three-letter ISO code representing the currency of an object. currency:EUR
    date: The date an object was created (identical to created). date:yesterday
    email: The email (either full address or part of one) of an object. email:jenny.rosen@example.com
    exp: The expiration date of the card associated with an object. exp:11/19
    flow: The type of flow for customer action that applies to a Sources payment. flow:redirect
    last4: The last four digits of the card associated with an object. last4:4080
    metadata: Metadata value on a supported object. Additional search options for metadata are also available. metadata:555-5555
    name: The cardholder or customer name associated with an object. name:jenny
    number: The unique number identifying an invoice. number:06b2b1a642-0023
    postal: The ZIP code associated with an object. postal:12345
    receipt: The receipt number used in a payment or refund email receipt. receipt:3330-2392
    risk_level: The risk level of a payment determined by Radar. risk_level:elevated
    status: The status of an object. status:canceled
    type: The type of payment method used for a Sources payment. type:ideal
    usage: The usage availability of a Sources payment method. usage:single_use
    zip: The ZIP code associated with an object. zip:12345

    You can use these operators when searching for amounts and dates to refine your search to a particular range.

    Operator Description Example
    > Greater than an amount, or after the specified date. amount:>149.99
    < Less than an amount, or before the specified date. date:<2017-10-24
    .. Within a range of dates or amounts. amount:50.00..99.99

    You can also use the Boolean operator is: with these operators.

    Operator Description Example
    charge A payment (identical to payment). is:charge
    captured A payment that has been captured. is:captured
    coupon A coupon. is:coupon
    customer A customer. is:customer
    disputed A payment that has been disputed. is:disputed
    invoice An invoice. is:invoice
    invoiceitem An invoice item. is:invoiceitem
    paid A payment or invoice that has been paid. is:paid
    payment A payment (identical to charge). is:payment
    payout A payout. is:payout
    plan A subscription plan. is:plan
    refunded A payment or invoice that has been refunded. is:refunded

    Combining and negating search terms

    You can use more than one search term to narrow down your search and reduce the number of results. You can also negate any search filter with a hyphen - so that matches for it are not included.

    Example Description
    last4:4242 exp:11/19 The last four digits of the card are 4242 and expiration date is 11/19.
    last4:4242 -exp:11/19 The last four digits of the card are 4242 and expiration date is not 11/19.
    type:ideal status:canceled iDEAL payments where the source has been canceled and not used to complete a payment.

    Metadata searches

    You can perform searches on metadata that you have added to objects that support it (e.g., payments). Metadata values are automatically included during a search for any text that does not use a filter.

    You can use the metadata: filter so the search term only looks up metadata values. To search for a specific metadata key-value pair, use the metadata key name as a filter, such as order_id:xyn712.

    Best practices

    Many searches can be performed with a single search term. Use something that would be fairly atypical, such as a name or email address. If you are seeing too few results, make the search term less specific. If there are too many results, include additional terms, one at a time.

    Use a wider range of values when using dates or amounts as search terms. Currency conversions and time zone differences between you and your customer are a common source of confusion when looking up information about a payment. Use additional search terms or even different ones altogether.

    As search terms are included in the URL, you can bookmark the search or share it with other team members as you would any other web page.