Search API

Retrieve the results of searches across various scopes of data. See Search Query and Filters for supported scopes. Search results are delivered in reverse chronological order by default.

Attributes

Name Type Description
object string

The string search.

location string

API path to retrieve the current search object.

aggregate_level integer

Aggregate Level up to which to fetch sub-merchants from the merchant hierarchy.

For example, when set to 1, fetch sub-merchants 1 level under the master merchant. When set to 2, fetch sub-merchants from levels 1 and 2 under the master merchant, and so on.

data array

Paginated search results.

export object_id_expandable

The export identifier matching /xprt(_test)?_[0-9a-z]+/.

filters object

Search filters (see search query and filters).

order string

Search results order.

page integer

Page for paginated results.

per_page integer

Records per page for paginated results.

query string

Search query (see search query and filters).

scope string

Search scope (type of data searched). See available scopes in Search Query and Filters

total integer

Number of records returned.

total_pages integer

Number of pages of records returned.

Example

  • JSON Response

- GET https://api.omise.co/search

Searches a scope of data based on input parameters. Note: the pagination mechanism for search results is different from that for lists. Use page and per_page instead of offset and limit.

Request Parameters

Name Type Description
scope string

(required, one of: charge, charge_schedule, customer, dispute, event, fund_account, link, log_entry, receipt, recipient, refund, sub_merchant, transfer, transfer_schedule, transaction) Search scope (type of data searched). See available scopes in Search Query and Filters

filters object

(optional) Search filters (see search query and filters).

order string

(optional, default: chronological, one of: chronological, reverse_chronological) Search results order.

page integer

(optional, default: 1) Page for paginated results.

per_page integer

(optional, default: 30) Records per page for paginated results. Default: 30. Maximum: 100.

query string

(optional) Search query (see search query and filters).

Example

  • Search using query and filters

Omise uses cookies to improve your overall site experience and collect information on your visits and browsing behavior. By continuing to browse our website, you agree to our Privacy Policy. Learn more