Search for serial numbers
Search for serial numbers
To search for a serial number, it is possible to specify one of the following parameters:
- serial number (in full or in part),
- license number (= DongleId, license ID, key ID)
- customer data (in full or in part),
- company name,
- first name,
- last name,
- email address,
- phone.
Authorization is required. RAW JSON input parameters:
{
"searchstring": "Lv"
}
POST /v1.0/search/serialnumbers
Pagination and sorting are available for the query. Available sorting fields: serial (by serial number string). Default sorting and pagination parameter values: sortby=serial&direction=asc&offset=0&limit=100.
The query can be filtered by serial number status: Normal(0), Blocked(1). By default, the query returns serial numbers with any status. Examples:
- specify status=1 -> get serial numbers with Blocked(1) status;
- specify status=0,1 -> get serial numbers with both Normal(0) and Blocked(1) status.
Returns the serialnumbers array:
{
"serialnumbers": [
{
"_id": 10176,
"activationcount": 1,
"activationlimit": 30,
"customer": {
"_id": 246,
"archivationdate": 0,
"archived": false,
"companyname": "",
"description": "Autocreated from activator info",
"email": "bma_customer@guardant.com",
"lastname": "",
"name": "bma_customer",
"phone": "+49 (0xx) xxxx-xxxx",
"status": 0,
"crmid": "",
"refid": ""
},
"dongleid": -1235188599,
"licensecontainerversion": 393218,
"serialstring": "LvHdHH-Ux1VmY-pGKq1y-NEE4pp-8iAAgP",
"status": 0
},
{
"_id": 10022,
"activationcount": 0,
"activationlimit": 3,
"dongleid": -1989049396,
"licensecontainerversion": 0,
"serialstring": "L6Jo6h-KLvZ6M-SzMs3K-64Uggc-7B2ZDG",
"status": 0
}
]
}
Search for hardware keys
To search for a hardware key, it is possible to specify one of the following parameters:
- key/license identifier (DongleId)
- customer details (in full or in part),
- company name,
- first name,
- last name,
- email address,
- phone.
Authorization is required. RAW JSON input parameters:
{
"searchstring": "baskin"
}
POST /v1.0/search/dongles
Pagination and sorting are available for the query. By default, the query result is sorted by dongleId. Default sorting and pagination parameter values: direction=asc&offset=0&limit=100.
Returns the dongles array:
{
"dongles": [
{
"_id": 6,
"customer": {
"_id": 10,
"archivationdate": 0,
"archived": false,
"companyname": "baskin&robings",
"crmid": "",
"description": "",
"email": "dfgsfg@dfg-df.com",
"lastname": "cream",
"name": "ice",
"phone": "+349534534534",
"refid": "",
"status": 0
},
"dongleid": 991846791,
"model": 2,
"netresource": 0,
"publiccode": 1368487351,
"typeflags": 442
}
]
}
Search for hardware keys and serial numbers
To search for a hardware key, it is possible to specify one of the following parameters:
- hardware key/license identifier (DongleId) (or serial number license identifier [= DongleId, license ID, key ID])
- serial number (in full or in part),
- customer details (in full or in part),
- company name,
- first name,
- last name,
- email address,
- phone.
Authorization is required. RAW JSON input parameters:
{
"searchstring": "baskin"
}
POST /v1.0/search/donglesandserials
Pagination and sorting are available for the query. By default, hardware keys (dongles) are sorted by dongleId, and serialnumbers are sorted by serial number string. Default sorting and pagination parameter values: direction=asc&offset=0&limit=100 - affect both the sorting of hardware keys and the sorting of serial numbers.
Returns the dongles and serialnumbers array:
{
"dongles": [
{
"_id": 6,
"customer": {
"_id": 10,
"archivationdate": 0,
"archived": false,
"companyname": "baskin&robings",
"crmid": "",
"description": "",
"email": "dfgsfg@dfg-df.com",
"lastname": "cream",
"name": "ice",
"phone": "+349534534534",
"refid": "",
"status": 0
},
"dongleid": 991846791,
"model": 2,
"netresource": 0,
"publiccode": 1368487351,
"typeflags": 442
}
],
"serialnumbers": [
{
"_id": 428,
"activationcount": 0,
"activationlimit": 1,
"customer": {
"_id": 10,
"archivationdate": 0,
"archived": false,
"companyname": "baskin&robings",
"crmid": "",
"description": "",
"email": "dfgsfg@dfg-df.com",
"lastname": "cream",
"name": "ice",
"phone": "+349534534534",
"refid": "",
"status": 0
},
"dongleid": -1175471063,
"licensecontainerversion": 0,
"serialstring": "TBSzoc-iQcoCF-Hr11Ba-uVsd45-wcZ1VB",
"status": 0
}
]
}
Search orders by order number/product number/product name/customer name/serial number/hardware key ID
Authorization is required. RAW JSON input parameters:
{
"searchstring":"Max",
"allowEmptySearchstring":true // optional parameter (false by default) allowing the use of an empty search string (in this case, the query will return all values).
}
POST /v1.0/search/orders
Pagination and sorting are available for the query. Available sorting fields: number (by order number), sumbmitdate (order confirmation date). Default sorting and pagination parameters: sortby=number&direction=asc&offset=0&limit=100.
Filter by order status is available for the query: Draft(0), Submit(1), Revoked(2). By default, the query returns orders with any status. If you need to select orders with specific statuses, list them separated by commas in the "status" query parameter. For example, specifying status=0,1 will return only orders with the Draft(0) and Submit(1) status.
Returns the orders array:
"orders": [
{
"_id": 10123,
"activationbirthdate": 1539936112,
"activationdeathdate": 1602277200,
"activationlimit": 1,
"canoverwritecontainer": false,
"customer": {
"_id": 5,
"companyname": "",
"description": "sw",
"email": "de@a",
"lastname": "",
"name": "Max",
"phone": "d",
"status": 1,
"crmid": "",
"refid": ""
},
"customerrequired": true,
"date": 1539936112,
"description": "test_cmpound",
"isdemo": false,
"number": 2,
"quantity": 1,
"status": 1,
"submitdate": 0,
"type": 1,
"crmid": "",
"refid": ""
},
{
"_id": 10082,
"activationbirthdate": 1536314029,
"activationdeathdate": 0,
"activationlimit": 1,
"canoverwritecontainer": false,
"customer": {
"_id": 5,
"companyname": "",
"description": "sw",
"email": "de@a",
"lastname": "",
"name": "Max",
"phone": "d",
"status": 1,
"crmid": "",
"refid": ""
},
"customerrequired": true,
"date": 1536314029,
"description": "1st update for LvHdHH-Ux1VmY-pGKq1y-NEE4pp-8iAAgP",
"isdemo": false,
"number": 1,
"quantity": 1,
"status": 1,
"submitdate": 0,
"type": 1,
"crmid": "",
"refid": ""
}
]
Search products by number/name
Authorization is required. RAW JSON input parameters:
{
"searchstring": "2",
"allowEmptySearchstring":true // optional parameter (false by default) allowing the use of an empty search string (in this case, the query will return all values).
}
POST /v1.0/search/products
Pagination and sorting are available for the query. Available sorting fields: number (by product number), name, archivationdate. Default sorting and pagination parameter values: sortby=number&direction=asc&offset=0&limit=100.
In this query, it is possible to specify the parameter status=draft (status=onsale) to select only products with the draft (onsale) status. If the parameter is not specified or does not match one of {draft, onsale}, then all products will be selected, regardless of their status.
The query has an optional parameter archived=false (archived=true) - it is used to display non-archived records (archived records). By default, the query displays all records - both archived and non-archived.
The query has an optional parameter licensetype=x,y,.. to filter records by license media type: software license (1), hardware key (2), software license and hardware key at the same time (0). The query will select only products intended for the specified license media types.
Returns the products array:
"products": [
{
"_id": 10046,
"accesscode_id": 4,
"description": "product45",
"flags": 0,
"modification": 0,
"name": "product45",
"productnumber": 45,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": []
},
{
"_id": 10047,
"accesscode_id": 4,
"description": "product42_1",
"flags": 0,
"modification": 1,
"name": "product42_1",
"productnumber": 42,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": []
},
{
"_id": 10012,
"accesscode_id": 4,
"description": "pr_1",
"flags": 0,
"modification": 0,
"name": "pr1",
"productnumber": 0,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": []
}
]
Search products by customer/serial number
To search for products, it is enough to specify in full or in part one of the following parameters:
- customer name,
- customer last name,
- company name,
- serial number.
Authorization is required. RAW JSON input parameters:
{
"searchstring": "2"
}
POST /v1.0/search_ext/products
Pagination and sorting are available for the query. Available sorting fields: number (by product number), name, archivationdate. Default sorting and pagination parameter values: sortby=number&direction=asc&offset=0&limit=100.
In this query, it is possible to specify the parameter status=draft (status=onsale) to select only products with the draft (onsale) status. If the parameter is not specified or does not match one of {draft, onsale}, then all products will be selected, regardless of their status.
The query has an optional parameter archived=false (archived=true) - it is used to display non-archived records (archived records). By default, the query displays all records - both archived and non-archived.
The query has an optional parameter licensetype=X to display record filtering by license media type (software license or hardware key). If licensetype=0, then the query will select only products intended for both software licenses and hardware keys at the same time. If licensetype=1, then the query will select only products intended for both software licenses and hardware keys at the same time, as well as products intended only for software licenses. If licensetype=2, then the query will select only products intended for both software licenses and hardware keys at the same time, as well as products intended only for hardware keys.
Returns the products array:
"products": [
{
"_id": 10046,
"accesscode_id": 4,
"description": "product45",
"flags": 0,
"modification": 0,
"name": "product45",
"productnumber": 45,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": [],
"features": [
{
"_id": 136,
"archivationdate": 0,
"archived": false,
"crmid": "",
"defaultLicense": {
"canexclude": true,
"canmodify": true,
"consumptionmode": 0,
"flags": 0,
"isremote": false,
"licensingmodel": 1,
"netlicensescount": 0,
"rentbegindate": 0,
"rentdayscount": 0,
"rentenddate": 0,
"runcounter": 0
},
"description": "f12274",
"featurenumber": 12274,
"name": "f12274",
"pubkey": "61 78 04 38 6F CC 61 9A E3 38 C6 11 12 8A 95 7B B0 A6 1B 41 E4 8D 17 B6 6F AE 1F 03 91 9A 68 88 B7 9A 8E 55 34 57 C4 58",
"refid": ""
}]},
{
"_id": 10047,
"accesscode_id": 4,
"description": "product42_1",
"flags": 0,
"modification": 1,
"name": "product42_1",
"productnumber": 42,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": [],
"features": [
{
"_id": 136,
"archivationdate": 0,
"archived": false,
"crmid": "",
"defaultLicense": {
"canexclude": true,
"canmodify": true,
"consumptionmode": 0,
"flags": 0,
"isremote": false,
"licensingmodel": 1,
"netlicensescount": 0,
"rentbegindate": 0,
"rentdayscount": 0,
"rentenddate": 0,
"runcounter": 0
},
"description": "f12274",
"featurenumber": 12274,
"name": "f12274",
"pubkey": "61 78 04 38 6F CC 61 9A E3 38 C6 11 12 8A 95 7B B0 A6 1B 41 E4 8D 17 B6 6F AE 1F 03 91 9A 68 88 B7 9A 8E 55 34 57 C4 58",
"refid": ""
}]}
]
Customer search by company name/name/family name/email/phone
Authorization is required. RAW JSON input parameters:
{
"searchstring": "ax",
"allowEmptySearchstring":true // optional parameter (false by default) allowing the use of an empty search string (in this case, the query will return all values).
}
POST /v1.0/search/customers
Pagination and sorting are available for the query. Available sorting fields: default (CompanyName,LastName,FirstName), name (LastName,FirstName), company (CompanyName). Default sorting and pagination parameter values: sortby=default&direction=asc&offset=0&limit=100.
In this request, it is possible to specify the parameter type=company (type=person) to select only legal entities (individuals). If the parameter is not specified or does not match one of {company, person}, then all customers (both companies and individuals) will be selected.
Returns the customers array:
"customers": [
{
"_id": 4,
"companyname": "",
"description": "",
"email": "mail@gmail.com",
"lastname": "",
"name": "Peter",
"phone": "8",
"status": 1,
"crmid": "",
"refid": ""
},
{
"_id": 1,
"companyname": "",
"description": "sd",
"email": "jane@air.com",
"lastname": "",
"name": "Jane",
"phone": "qq",
"status": 1,
"crmid": "",
"refid": ""
},
{
"_id": 419,
"companyname": "google",
"description": "omg",
"email": "ar@ae.com",
"lastname": "",
"name": "John",
"phone": "8989",
"status": 1,
"crmid": "",
"refid": ""
}
]
Feature search by number/name
Authorization is required. RAW JSON input parameters:
{
"searchstring": "71"
}
POST /v1.0/search/features
Pagination and sorting are available for the query. Available sorting fields: number, name. Default values of sorting and pagination parameters: sortby=number&direction=asc&offset=0&limit=100.
The query has an optional parameter archived=false (archived=true) - it is used to display non-archived records (archived records). By default, the query displays all records - both archived and non-archived.
Returns the features array:
"features": [
{
"_id": 10042,
"description": "feature71",
"featurenumber": 71,
"name": "feature71",
"pubkey":"F9 E5 EC 6B 52 54 BC 80 45 7D 49 BB F0 61 F9 F2 EC AA 9F 63 79 32 0A B6 77 44 8A E7 16 AC C1 82 8A 14 73 1E 56 B6 EF 53"
"crmid": "",
"refid": ""
},
{
"_id": 10043,
"description": "feature72",
"featurenumber": 72,
"name": "feature72",
"pubkey":"11 45 0A B6 77 EC AA 9F 63 79 32 C1 82 8A 14 EC 6B 52 54 BC 80 45 7D 49 BB 73 1E 56 6B 52 54 BC 80 45 7D 34 56 BB AA 99"
"crmid": "",
"refid": ""
},
{
"_id": 10044,
"description": "feature73",
"featurenumber": 73,
"name": "feature73",
"pubkey":"44 8A E7 16 AC EC 6B 52 54 BC 80 45 7D 49 BB 73 1E 56 6B 52 54 BC 80 45 7D 49 BB F0 61 F9 F2 EC AA 9F 63 79 32 0A B6 C3"
"crmid": "",
"refid": ""
}
]
Get serial number activation history
Authorization is required. RAW JSON input parameters:
{
serialNumber: "LvHdHH-Ux1VmY-pGKq1y-NEE4pp-8iAAgP"
}
POST /v1.0/getserialhistory
Returns the history array:
"history":
[
{
"_id":52,
"action": 2,
"actiondate":1530775886,
"actionresult":0,
"hdd":"12 FA DE 3E ..",
"mb":"48 56 34 FF ..",
"hardwareData": "Intel I7 6585 ..."
"customer":
{
"_id":5,
"description":"sw",
"email":"de@a",
"name":"Max",
"phone":"9037771527",
"status":1,
"crmid": "",
"refid": ""
}
},
...
]
Search for memory cells by name or ID
Authorization is required. RAW JSON input parameters:
{
"searchstring": "my"
}
POST /v1.0/search/memoryitems
Pagination and sorting are available for the query. Available sorting fields: aliasid, name (by default).
Returns the memoryitems array:
{
"memoryitems": [
{
"_id": 3,
"accesstype": 1,
"action": 1,
"aliasid": 37,
"crmid": "",
"description": "mylicense",
"name": "mylicense",
"params": [
{
"_id": 2,
"data": "VVZXWFlgYWJj",
"description": "param_first",
"editallowed": true,
"name": "param_first",
"offset": 0,
"size": 9
},
{
"_id": 3,
"data": "VVZXWFlgYWJjZA==",
"description": "param1",
"editallowed": true,
"name": "param1",
"offset": 20,
"size": 10
}
],
"readpassword": 123,
"refid": "",
"size": 100,
"totalparams_size": 30,
"writepassword": 0
}
]
}
