CLclover
CHARGES

Get charges

Displays a list of existing charges. First displays the newest charge in the list. See Get charges tutorials for more information.

get/v1/charges

Request

  • Base URL
    https://scl-sandbox.dev.clover.com
  • URL
    https://scl-sandbox.dev.clover.com/v1/charges
  • Auth
    OAuth 2
    Authorization code: https://sandbox.dev.clover.com/oauth/authorize
    Token URL: https://sandbox.dev.clover.com/oauth/token

Query parameters

gtstring date-time

Displays results when the created field is greater than the current value.

gtestring date-time

Displays results when the created field is greater than or equal to the current value.

ltstring date-time

Displays results when the created field is less than the current value.

ltestring date-time

Displays results when the created field is less than or equal to the current value.

customerstring

Displays charges associated with the provided customer ID.

ending_beforestring

Cursor used in pagination. The ending_before object ID sets your place in the list. For example, if you receive 100 objects in a list starting with obj_bar, add ending_before=obj_bar in your subsequent request to retrieve the previous page of the list.

expandstring[]

Additional information provided as an expanded response, for example, a related object nested within the parent. See Use expandable fields.

limitinteger

Number of objects returned by the request, ranging between 1 and 100. Default: 10

threeds_validation_resultstring

EMV® 3-D Secure (3DS) authentication result. 3-D Secure is a protocol that provides an additional security layer for online credit and debit card-not-present (CNP) transactions.

is_threedsboolean

Indicates whether the transaction is 3-D Secure authenticated.

starting_afterstring

Cursor used in pagination. The starting_after object ID sets your place in the list. For example, if you receive 100 objects in a list starting with obj_foo, add starting_after=obj_foo in your subsequent request to retrieve the next page of the list.

Headers

User-Agentstring required

Identifies the application, operating system, vendor, and/or version of the requesting user agent. Format: <product> / <product-version> <comment>

Response

Successful response. Charges displayed.

has_moreboolean required

Indicates whether the list of charges are spread to further pages.

object'list' required

Object type. Example: List

urlstring required

URL of the list of charges.

Changes

No recorded changes to this operation across all 1 revision of this API.