Knowledge Base

Search Managed Linux Server Orders Using the API

When you want to search Managed Linux Server orders using the API. This article explains available search filters, order status options, sorting, pagination, and response details for matching server orders.

Search Orders

Description

Gets a list and details of the Managed Server Linux Orders matching the search criteria.

Parameters

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Authentication Parameter
api-key	String	Required	Authentication Parameter
no-of-records	Integer	Required	Number of Orders to be fetched
page-no	Integer	Required	Page number for which details are to be fetched
order-id	Array of Integers	Optional	Order ID(s) of the Managed Server Linux Order(s) whose details need to be fetched
reseller-id	Array of Integers	Optional	Reseller ID(s) whose Managed Server Linux Orders need to be fetched
customer-id	Array of Integers	Optional	Customer ID(s) whose Managed Server Linux Orders need to be fetched
show-child-orders	Boolean	Optional	Whether Sub-Reseller Orders need to be fetched or not
status	Array of Strings	Optional	Status of the Order: Active, InActive, Suspended or Deleted
domain-name	String	Optional	Name of the Domain of the Managed Server Linux Order
creation-date-start	String	Optional	UNIX TimeStamp for listing of the Managed Server Linux Orders whose Creation Date is greater than creation-date-start
creation-date-end	String	Optional	UNIX TimeStamp for listing of the Managed Server Linux Orders whose Creation Date is less than creation-date-end
expiry-date-start	String	Optional	UNIX TimeStamp for listing of the Managed Server Linux Orders whose expiry date is greater than expiry-date-start
expiry-date-end	String	Optional	UNIX TimeStamp for listing of the Managed Server Linux Orders whose expiry date is less than expiry-date-end
order-by	Array of Strings	Optional	One or more parameters by which you want to sort the Orders. Default is orderid. Example: If page-no is 1, no-of-records is 30 and order-by is orderid; it will fetch the first 30 Orders which suit the search criteria sorted by orderid. If page-no is 2, no-of-records is 30 and order-by is orderid; it will fetch the second batch of 30 Orders sorted by orderid.

HTTP Method

GET

Example Test URL Request

https://test.httpapi.com/api/managedserver/linux/us/search.json?auth-userid=0&api-key=key&no-of-records=1&page-no=1

Response

Returns a hash map containing the below details of the Managed Server Linux Orders which match the search criteria:

Domain Name (entity.description)
Order Id (orders.orderid)
Customer Id (entity.customerid)
Order Creation Timestamp (orders.creationtime)
Order Expiry Timestamp (orders.endtime)
Current Order Status (entity.currentstatus) - value will be InActive, Active, Suspended or Deleted
Product Name (entitytype.entitytypename)
Product Key (entitytype.entitytypekey)
Type of Operating System (hosting_group_info.os_type)
Data Center location for the Managed Server (hosting_group_info.location)

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.

Did you find this article helpful?