post https://api.clientpay.com/v2/paymentsearch/results
Pass in query parameters and get back a list of payment objects that match the criteria for the specified page number and page size. Always call the Count endpoint first in order to inform how many pages you'll need to request. Results are limited to payments made against the merchant account tied to accessId used, but payments do not have to have been originated via API in order to be included.
Syntax can be a bit tricky here, but that's because this endpoint supports any number of nested groupings of conditions/criteria. The conditions field acts only as an array of criteria objects.
Header Parameters
Parameter | Type | Description |
---|---|---|
accessId* | String | Unique identifier that ensures that the integrator has the authorization to make requests on behalf of the customer. (Specifically, a customer's merchant account) |
Body Parameters
Parameter | Type | Description |
---|---|---|
group* | Object/Hash | Defines a group of conditions to which the group's type will be applied when querying. |
type* | String | Accepts either "and" or "or". If "and", then query results must match all conditions in group. If "or", then query results must match any condition in group. |
conditions* | Array of (Criteria) Objects | The conditions array supports any number of criteria objects. |
criteria* | Object/Hash | Each criteria object can be defined as a search parameter. For more info, check out the Criteria Object defitions. |
orderBy | Array of Strings | Default is paymentDate. Can be ordered by paymentDate, paymentId, sessionId, or requestId in ascending order. |
pageNumber | Integer | Default is 1. Determines which page of results will be returned. For example, if pageNumber is set to 2 and pageSize to 100, then the query will return results 101-200. |
pageSize | Integer | Default and max is 100. Determines number of results being returned. |