bright, fresh software
Downloads  |  Buy

limelm.pkey.advancedSearch

Find all the product keys based on search parameters.

Note: This function is not a "drop-in" replacement for limelm.pkey.find. For instance, in limelm.pkey.find when you leave the email parameter blank you'll get no product keys. However, if you leave the email parameter blank in this function you'll get all product keys.

Arguments

api_key (Required)
Your API application key. Your api key is available on your settings page.
num (Optional)
The number of product keys to return per page. If this parameter is missing (or invalid) then it will default to 20.
page (Optional)
The page you're currently on. If this parameter is missing (or invalid) then it will default to 1.
product_id (Optional)
The id of the version to search for the product key. You can get the product ID by examining the URL in your browser. For instance, from the URL https://wyday.com/limelm/product/view/101/ you can see the product ID is 101.

If the product_id parameter is not present then this function will search all products in your LimeLM account (unless a version_id parameter is specified).
version_id (Optional)
The id of the version to search for the product key. You can get the version ID by examining the URL in your browser. For instance, from the URL http://wyday.com/limelm/version/100/ you can see the version ID is 100. (Note: The Version ID is not the Version GUID).

If the version_id parameter is not present then this function will search all versions in your LimeLM account (unless a product_id parameter is specified).
email (Optional)
The email associated with the product key. If you don't specify this parameter then this function will ignore the email field. You can also use the asterisk wildcard character "*" to do partial matches of emails.
tag[] (Optional)
Search for product keys with any of the provided tags. You can also use the asterisk wildcard character "*" to do partial matches of tags. For instance, if you have product keys with a "Microsoft" tag and some product keys with a "MicroSD" tag you can either specify both of these tags separately… 
tag[]=Microsoft
tag[]=MicroSD
…or you can use the wildcard character: 
tag[]=Micro*
It should also be noted that tags are not case sensitive (searching for "Microsoft" is the same as searching for "microsoft" or "miCrOsoFT").
start (Optional)
The start of the date range in the form YYYY-MM-DD (e.g. 2010-06-25) or YYYY-MM-DD hh:mm:ss. If this value is not present it finds all product keys created since the beginning of time.
end (Optional)
The end of the date range in the form YYYY-MM-DD (e.g. 2011-06-25) or YYYY-MM-DD hh:mm:ss. If this value is not present it finds all product keys created up until the present time.
get_acts (Optional)
Whether or not to get the activations for the product keys. Possible values are "true" and "false". If this parameter isn't present (or is invalid) it will default to "false".
get_features (Optional)
Whether or not to get the features for the product keys. Possible values are "true" and "false". If this parameter isn't present (or is invalid) it will default to "false".
get_tags (Optional)
Whether or not to get the tags for the product keys. Possible values are "true" and "false". If this parameter isn't present (or is invalid) it will default to "false".

Example Response

The method returns a list of product keys, the total number of pages, and the total number of matching product keys.

<pkeys pages="1" total="3">
    <pkey id="103" key="A84U-ZTZT-V2WI-5KCK-EV5S-3PWK-K2TX" acts="4" acts_used="3" email="mike.nelson@example.com"/>
    <pkey id="104" key="X8ZB-FRRK-PVWX-M3RY-YPE8-ARFM-N2TX" acts="1" acts_used="1" email="art.crow@example.com"/>
    <pkey id="107" key="37CU-6XJN-5V6S-KY4C-GIDD-BXP7-F6TX" acts="1" acts_used="0" revoked="true"/>
</pkeys>

Error Codes

1: Product key not found.
No product keys found for the email address specified.
100: Invalid API Key
The API key passed was not valid or has expired.
101: Method "xxx" not found
The requested method was not found.
142: Service currently unavailable
The requested service is temporarily unavailable.