Python 3: Product - Devolens (formerly Cryptolens) Documentation

Python 3 package licensing 0.54. Reviewed source revision.

from licensing.methods import Product

get_products

Retrieve the products accessible to the access token.

Product.get_products(token)

Parameters

Parameter	Default	Meaning
`token`	Required	Your access token. It needs the permission required by the linked Web API method.

Result

Returns (products, ''), where products is a list of dictionaries. Returns (None, message) for API rejection or a handled request failure. Malformed response data can raise an exception.

Checks

The API checks the access token’s permissions. This method does not verify a signed license response. Web API reference.

get_keys

Search a product’s license keys and retrieve one page of results.

Product.get_keys(token, product_id, page=1, order_by='ID ascending', search_query='')

Parameters

Parameter	Default	Meaning
`token`	Required	Your access token. It needs the permission required by the linked Web API method.
`product_id`	Required	The numeric product ID.
`page`	`1`	The page number, starting at 1.
`order_by`	`'ID ascending'`	The API’s ordering expression.
`search_query`	`''`	The dashboard search expression to apply to license keys.

Result

Returns (license_keys, '', pagination). license_keys is a list of dictionaries, not LicenseKey objects. pagination is a dictionary with returned, total and pageCount. Returns a two-item (None, message) tuple on API rejection or a handled request failure. Check the first item before reading pagination. Malformed response data can raise an exception.

Checks

The API checks access permissions. These results are not signed license objects for offline verification. Web API reference.

Example

This counts licenses created in the 2026 UTC calendar year for example product 3349. Replace the access token and product ID; the access token needs the GetKeys permission.

result = Product.get_keys(
    token="YOUR_ACCESS_TOKEN", product_id=3349,
    search_query="created >= DateTime(2026,1,1) and created < DateTime(2027,1,1)")
if result[0] is None:
    print("Search failed: {0}".format(result[1]))
else:
    print("Matching licenses: {0}".format(result[2]["total"]))

FAQ

Why Should I Use the Total Instead of Counting the List?

The list contains only the requested page. result[2]["total"] is the number matching the filter across all pages of that product. returned is the number on the current page. For several products, sum their filtered totals.

Python SDK Reference

​get_products

​Parameters

​Result

​Checks

​get_keys

​Parameters

​Result

​Checks

​Example

​FAQ

get_products

Parameters

Result

Checks

get_keys

Parameters

Result

Checks

Example

FAQ