Search Tips
Use the Speed dashboard search functionality to search for payments, and more. This built-in search feature can help you find essential resources and navigate across different Speed resources.
It allows you to search for objects belonging to a specific resource type and apply filters. The searchable resource types are listed below.
Use [is
] before the resource name, and then type in more filters if you want to minimize the number of matches for the search.
To refine your search, preface a search term with one of the following filters. Many fields are shared across different objects. For example, the "amount" field applies to payments, checkout links, and more. In such cases, using the [is]
filter will yield more precise matches within the top 10 results.
When you perform a search, the top 10 results will appear directly in the dropdown below the search box. To view all matches, either click “Show all results” or press Enter. You will then be directed to a detailed results page, which will have all the search results organized based on the resource type.
The top 10 matches shown are sorted in descending order by the timestamp created
. This is the default sort applied by Speed search. To sort results using different filters, use sort
in your query, as shown below:
Use the field sort:
with the following clause:
Value | Example | Description |
---|---|---|
created | sort:-created | Sorts the result set by the newest record first (Default) |
amount | sort:-amount | Sorts the result set by the highest amount first |
amount | sort:amount | Sorts the result set by the lowest amount first |
Additionally, you can use (-
) to negate the query, as shown in the above example.
Example:
is:payment amount>100 sort:-amount
- This will search for
payment
objects that have anamount
greater than 100. The resulting list will be sorted in descending order based on theamount
field.
Filters
The dashboard automatically searches for the most relevant information based on your query terms. You can use search filters and operators to have more granular control. The more terms you include in your search query, the more refined the results will be.
Field Name | Type | Operators | Usage | Description |
---|---|---|---|---|
Currency | Token | :(is) | currency:”usd” | The three-letter ISO code for currency. |
Amount | Numeric | :(is) ..(is between) <(less than) <=(less than or equal) =(equals) >(greater than) >=(greater than or equal) | amount>1000 | The amount of an object. |
Name | String | :(is) | name:"John" | In the context of products, the "Name" parameter refers to the name of the product. When dealing with customer-related functionality, the "Name" parameter represents the name of the customer. |
Target Currency | Token | :(is) | target_currency:”sats” | The crypto-currency used for the object. |
Target Amount | Numeric | ..(is between) <(less than) <=(less than or equal) =(equals) >(greater than) >=(greater than or equal) | target_amount:10..20 | The amount of an object in target currency. |
Target Amount Paid | Numeric | :(is) ..(is between) <(less than) <=(less than or equal) =(equals) >(greater than) >=(greater than or equal) | target_amount_paid>1000 | The amount of funds are transferred for a payment resource. |
ID | String | :(is) | id:”pi_l3v6fgis9h9YcDIV” | The ID of the object is matched. |
Description | String | :(is) ~(contains) | description:”order id:23” | Additional information about the payment resource. |
Status | Token | :(is) | status:”paid” | The status of an object such as, “active”, “expired”, “deactivated” and others. |
Created | Numeric | :(is) ..(is between) <(less than) <=(less than or equal) =(equals) >(greater than) >=(greater than or equal) | created=12-29-2022 | The date an object was created. |
Statement Descriptor | String | :(is) ~(contains) | statement_descriptor:”payment” | The statement descriptor given to a payment resource. |
Billing phone | String | :(is) | billing_phone: "7506119541” | Customer’s phone number |
URL | String | :(is) | url:”cs_test_l3mvy93hxOTgrJAV” | The URL of the resource. |
IS | Token | :(is) | is:”payment” | The object for search |
Sort | :(is) | sort:created | The object which will be used for sorting. | |
String | :(is) | email:[email protected] | The email address present in an object. | |
Metadata | Token | :(is) | metadata:value_1 | The data of the metadata object whose value matches the search keyword. |
Operators
To refine your search within a specific range, you can use the following operators:
TYPE | OPERATORS |
---|---|
token | exact match (case insensitive) |
string | exact match (:), substring (~) (case insensitive) |
numeric | >(greater than) <(less than) <=(less than or equal) >=(greater than or equal) =(equals) ..(is between) |
For more proper matches, formulate queries using the fields mentioned below. For more details, refer to Speed SQL. You can use the following operators to formulate your query.
Different ways to use created filter:
Value | Example | Operators |
---|---|---|
today | - created:today | : = > < >= <= |
yesterday | -created<yesterday | : = > < >= <= |
yyyy/MM/dd yyyy-MM-dd yyyy-M-dd yyyy-MM-d yyyy-M-d yyyyMMdd | created<=20221229 | : = > < >= <= |
MM/dd/yyyy MM-dd-yyyy M/dd/yyyy M-dd-yyyy MM/dd/yy MM-dd-yy | created=12-29-2022 | : = > < >= <= |
dd/MM/yyyy dd.MM.yyyy dd/M/yyyy dd.M.yyyy d/M/yyyy d.M.yyyy dd/MM/yy dd.MM.yy | created:29/12/2022 | : = > < >= <= |
last | - created:”last 100 minutes” - created=”last 2 hours” - | : = > < >= <= |
past | created>=”past 5 months” - created<=”past year” | : = > < >= <= |
ago | - created>”10 weeks ago” - created<”150 minutes ago” | : = > < >= <= |
timestamp | created>=1672298100223 | : = > < >= <= |
Currency conversions and time zone differences between you and your customer can cause confusion when looking up payment information. In such cases, additional search terms. To get relevant matches for your search, make sure to set your date format in your profile settings. If you haven't done so yet, the default date format precedence will be used as follows:
yearMonthDay
dayMonthYear
monthDayYear
Suppose the date format is mm-dd-yyyy
set in the profile then precedence will be,
yearMonthDay
monthDayYear
dayMonthYear
Bookmark searches
We include the search terms in the URL. So, you can bookmark the search or share it with other team members as you would with any other web page.
Updated 3 months ago