Get Orders by Date Range

This API endpoint allows developers to retrieve a list of orders within a specific date range. The API requires authentication through an access token, and the input parameters are the 'from' and 'to' dates in the format of YYYY-MM-DD.

Request Type:

GET

Endpoint

📘

Production Server:

https://restapi.paylink.sa/api/getOrdersByDateRange

📘

Testing Server:

https://restpilot.paylink.sa/api/getOrdersByDateRange

Request Headers:

HeaderRequiredDescription
AuthorizationYesAn access token obtained through the authentication process
acceptYesThe expected response format. application/json

Query Parameters

ParameterValue TypeRequiredDescription
fromstring (YYYY-MM-DD)YesThe start date for the date range to retrieve orders from
tostring (YYYY-MM-DD)YesThe end date for the date range to retrieve orders from

Response Body:

The response will be an array of JSON objects that includes all relevant information for the orders retrieved within the specified date range. For more details, click here.

NameTypeDescription
orderIdintegerThe unique identifier of the order
orderNumberstringThe unique order number
orderDatedateThe date and time the order was placed, in Unix timestamp
orderAmountfloatThe total amount of the order, in the currency
paylinkFeesfloatThe fees charged by Paylink, if applicable
paylinkVatfloatThe VAT charged by Paylink, if applicable
notestringA note associated with the order
clientNamestringThe name of the client who placed the order
clientMobilestringThe phone number of the client who placed the order
isReconciledbooleanIndicates whether the order has been reconciled
settlementNumberstringThe settlement number, if applicable
settlementBankstringThe bank account number for the settlement, if applicable
settlementAmountfloatThe amount settled, if applicable
settlementIbanstringThe IBAN for the settlement, if applicable

Error Responses

  • Status Code: 401 Unauthorized
  • Status Code: 404 Not Found