The LicenseSpot API allows you to interact with our system from your own programs and applications. Using the API you can access resources like:
The API works in general receiving XML responses and sending XML requests.
The URL for the API includes three general parameters to invoke a request:
Below an example of the URL:
https://app.licensespot.com/Api/Api.ashx?method=licensespot.customer.get&data=<Params><CustomerId>0FFE4562-844A-4e18-A7B9-F3F4344C793A</CustomerId></Params>&apikey=296020E3-0458-4f6c-B90B-6D461BDD255D
Below an example of a response:
<?xml version='1.0' encoding='utf-8' ?>
<rsp stat='ok'>
<Customer>
<CustomerId>23D10086-9D85-43d4-9318-1CA76DE9186F</CustomerId>
<Name>John Smith</Name>
<Email>john.smith@domain.com</Email>
<Company>SkyXoft</Company>
<Phone>888-759-9638</Phone>
<Street1>8260 NW 14th</Street1>
<Street2></Street2>
<City>Doral</City>
<PostalCode>33126</PostalCode>
<Country>US</Country>
<State>FL</State>
</Customer>
</rsp>
A response with a failure:
<?xml version='1.0' encoding='utf-8' ?>
<rsp stat='fail'>
<err code='101' msg='the API key is invalid.'/>
</rsp>
Below the different methods you can execute regarding customers
Adds a customer to the database.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the customer and the customer ID.
<Customer>
<CustomerId>23D10086-9D85-43d4-9318-1CA76DE9186F</CustomerId>
<Name>John Smith</Name>
<Email>john.smith@domain.com</Email>
<Company>SkyXoft</Company>
<Phone>888-759-9638</Phone>
<Street1>8260 NW 14th</Street1>
<Street2></Street2>
<City>Doral</City>
<PostalCode>33126</PostalCode>
<Country>US</Country>
<State>FL</State>
</Customer>
Gets a customer in the database. The customer ID field is used to locate the customer. Also the customer email can be used.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the customer and the customer ID.
<Customer>
<CustomerId>23D10086-9D85-43d4-9318-1CA76DE9186F</CustomerId>
<Name>John Smith</Name>
<Email>john.smith@domain.com</Email>
<Company>SkyXoft</Company>
<Phone>888-759-9638</Phone>
<Street1>8260 NW 14th</Street1>
<Street2></Street2>
<City>Doral</City>
<PostalCode>33126</PostalCode>
<Country>US</Country>
<State>FL</State>
</Customer>
Updates a customer in the database. The customer ID field is used to locate the customer.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the customer and the customer ID.
<Customer>
<CustomerId>23D10086-9D85-43d4-9318-1CA76DE9186F</CustomerId>
<Name>John Smith</Name>
<Email>john.smith@domain.com</Email>
<Company>SkyXoft</Company>
<Phone>888-759-9638</Phone>
<Street1>8260 NW 14th</Street1>
<Street2></Street2>
<City>Doral</City>
<PostalCode>33126</PostalCode>
<Country>US</Country>
<State>FL</State>
</Customer>
Gets all customers in the database.
The method returns the details about the customer and the customer ID.
<Customers>
<Customer>
<CustomerId>23D10086-9D85-43d4-9318-1CA76DE9186F</CustomerId>
<Name>John Smith</Name>
<Email>john.smith@domain.com</Email>
<Company>SkyXoft</Company>
<Phone>888-759-9638</Phone>
<Street1>8260 NW 14th</Street1>
<Street2></Street2>
<City>Doral</City>
<PostalCode>33126</PostalCode>
<Country>US</Country>
<State>FL</State>
</Customer>
</Customers>
Get licenses from a customer in the database. The customer ID field is used to locate the customer. Also the customer email can be used.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the licenses the customer has.
<Licenses>
<License>
<LicenseId>23D10086-9D85-43d4-9318-1CA76DE9186F</LicenseId>
<CustomerId>F749B40A-EA9E-4392-9519-D334D8FB99A3</CustomerId>
<ProductId>8FC1DA7A-96EB-450f-A7E1-223EE6AA9BAB</ProductId>
<ProductVersionId>065F1F66-B0C3-4712-9920-3135561A7E1A</ProductVersionId>
<LicenseTemplateId>FA23A829-78E6-40c8-B398-89198CAA0A16</LicenseTemplateId>
<LicenseStatus>Active</LicenseStatus>
<CreatedDate>2011-02-08</CreatedDate>
<Comments>Important Customer</Comments>
<Properties>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
</Properties>
</License>
</Licenses>
Below you can find all the methods that can be used for licenses.
Activates a license provided the serial number and hardware ID of the calling machine. Returns the license content in XML format.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<SerialNumber>AOF4-DR34-4REW-EW@0-SFT2-4313-DSR3</SerialNumber>
<CreatedDate>2011-01-25</CreatedDate>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
<Limits>
<Limit type="Activation" gracePeriod="30" useHardwareLock="True" hardwareId="npG1VxCx5+snErGzA7xBB5Dd9DE=" />
<Limit type="Trial" startDate="2011-03-01" endDate="2011-03-30" />
</Limits>
</License>
Creates a new license in the system from a license template and a customer.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<SerialNumber>AOF4-DR34-4REW-EW@0-SFT2-4313-DSR3</SerialNumber>
<CreatedDate>2011-01-25</CreatedDate>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
<Limits>
<Limit type="Activation" gracePeriod="30" useHardwareLock="True" hardwareId="npG1VxCx5+snErGzA7xBB5Dd9DE=" />
<Limit type="Trial" startDate="2011-03-01" endDate="2011-03-30" />
</Limits>
</License>
Gets information about a license.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<LicenseId>23D10086-9D85-43d4-9318-1CA76DE9186F</LicenseId>
<CustomerId>F749B40A-EA9E-4392-9519-D334D8FB99A3</CustomerId>
<ProductId>8FC1DA7A-96EB-450f-A7E1-223EE6AA9BAB</ProductId>
<ProductVersionId>065F1F66-B0C3-4712-9920-3135561A7E1A</ProductVersionId>
<LicenseTemplateId>FA23A829-78E6-40c8-B398-89198CAA0A16</LicenseTemplateId>
<LicenseStatus>Active</LicenseStatus>
<CreatedDate>2011-02-08</CreatedDate>
<Comments>Important Customer</Comments>
<Properties>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
</Properties>
</License>
Verifies a license is genuine (if it hasn't been revoked in any way and all limits are still valid).
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the genuine method.
<result>
<IsGenuine>true</IsGenuine>
<TimeStamp>2011-2-7 21:44:32</TimeStamp>
</result>
Verifies a license subscription is active. The license must have the subscription limit for this method to work.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the is subscription active method.
<result>
<IsActive>true</IsActive>
<TimeStamp>2011-2-7 21:44:32</TimeStamp>
</result>
Get activations for a specific license.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about activations.
<Activations>
<Activation>
<ActivationDate>6/21/2012</ActivationDate>
<ActivationSatus>Unactive</ActivationSatus>
<HardwareId>YRtW4IuufGSxszxRQqFcJkodP+4=</HardwareId>
<IPAddress>127.0.0.1</IPAddress>
</Activation>
<Activation>
<ActivationDate>6/17/2012</ActivationDate>
<ActivationSatus>Unactive</ActivationSatus>
<HardwareId>YRtW4IuufGSxszxRQqFcJkodP+4=</HardwareId>
<IPAddress>127.0.0.1</IPAddress>
</Activation>
</Activations>
Deactivates a license that was previouly activated. The license must have the activation limit for this method to work.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the is subscription active method.
<License>
<SerialNumber>AOF4-DR34-4REW-EWY0-SFT2-4313-DSR3</SerialNumber>
<CreatedDate>2011-01-25</CreatedDate>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
<Limits>
<Limit type="Activation" gracePeriod="30" useHardwareLock="True" hardwareId="npG1VxCx5+snErGzA7xBB5Dd9DE=" />
<Limit type="Trial" startDate="2011-03-01" endDate="2011-03-30" />
</Limits>
</License>
Cancels a subscription. The license must have the subscription limit for this method to work.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the is subscription active method.
<result>
<IsActive>false</IsActive>
<TimeStamp>2011-2-7 21:44:32</TimeStamp>
</result>
Activates a subscription. The license must have the subscription limit for this method to work.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the is subscription active method.
<result>
<IsActive>false</IsActive>
<TimeStamp>2011-2-7 21:44:32</TimeStamp>
</result>
Get licenses based on a customer ID.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<LicenseId>23D10086-9D85-43d4-9318-1CA76DE9186F</LicenseId>
<CustomerId>F749B40A-EA9E-4392-9519-D334D8FB99A3</CustomerId>
<ProductId>8FC1DA7A-96EB-450f-A7E1-223EE6AA9BAB</ProductId>
<ProductVersionId>065F1F66-B0C3-4712-9920-3135561A7E1A</ProductVersionId>
<LicenseTemplateId>FA23A829-78E6-40c8-B398-89198CAA0A16</LicenseTemplateId>
<LicenseStatus>Active</LicenseStatus>
<CreatedDate>2011-02-08</CreatedDate>
<Comments>Important Customer</Comments>
<Properties>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
</Properties>
</License>
Get licenses based on a property value.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<LicenseId>23D10086-9D85-43d4-9318-1CA76DE9186F</LicenseId>
<CustomerId>F749B40A-EA9E-4392-9519-D334D8FB99A3</CustomerId>
<ProductId>8FC1DA7A-96EB-450f-A7E1-223EE6AA9BAB</ProductId>
<ProductVersionId>065F1F66-B0C3-4712-9920-3135561A7E1A</ProductVersionId>
<LicenseTemplateId>FA23A829-78E6-40c8-B398-89198CAA0A16</LicenseTemplateId>
<LicenseStatus>Active</LicenseStatus>
<CreatedDate>2011-02-08</CreatedDate>
<Comments>Important Customer</Comments>
<Properties>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
</Properties>
</License>
Set value to a license property.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<LicenseId>23D10086-9D85-43d4-9318-1CA76DE9186F</LicenseId>
<CustomerId>F749B40A-EA9E-4392-9519-D334D8FB99A3</CustomerId>
<ProductId>8FC1DA7A-96EB-450f-A7E1-223EE6AA9BAB</ProductId>
<ProductVersionId>065F1F66-B0C3-4712-9920-3135561A7E1A</ProductVersionId>
<LicenseTemplateId>FA23A829-78E6-40c8-B398-89198CAA0A16</LicenseTemplateId>
<LicenseStatus>Active</LicenseStatus>
<CreatedDate>2011-02-08</CreatedDate>
<Comments>Important Customer</Comments>
<Properties>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
</Properties>
</License>
Enables a license after it has been revoked.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<LicenseId>23D10086-9D85-43d4-9318-1CA76DE9186F</LicenseId>
<CustomerId>F749B40A-EA9E-4392-9519-D334D8FB99A3</CustomerId>
<ProductId>8FC1DA7A-96EB-450f-A7E1-223EE6AA9BAB</ProductId>
<ProductVersionId>065F1F66-B0C3-4712-9920-3135561A7E1A</ProductVersionId>
<LicenseTemplateId>FA23A829-78E6-40c8-B398-89198CAA0A16</LicenseTemplateId>
<LicenseStatus>Active</LicenseStatus>
<CreatedDate>2011-02-08</CreatedDate>
<Comments>Important Customer</Comments>
<Properties>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
</Properties>
</License>
Revokes a license.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<LicenseId>23D10086-9D85-43d4-9318-1CA76DE9186F</LicenseId>
<CustomerId>F749B40A-EA9E-4392-9519-D334D8FB99A3</CustomerId>
<ProductId>8FC1DA7A-96EB-450f-A7E1-223EE6AA9BAB</ProductId>
<ProductVersionId>065F1F66-B0C3-4712-9920-3135561A7E1A</ProductVersionId>
<LicenseTemplateId>FA23A829-78E6-40c8-B398-89198CAA0A16</LicenseTemplateId>
<LicenseStatus>Active</LicenseStatus>
<CreatedDate>2011-02-08</CreatedDate>
<Comments>Important Customer</Comments>
<Properties>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
</Properties>
</License>
Gets the license content provided the serial number and hardware ID of the calling machine. Returns the license content in XML format.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<SerialNumber>AOF4-DR34-4REW-EW@0-SFT2-4313-DSR3</SerialNumber>
<CreatedDate>2011-01-25</CreatedDate>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
<Limits>
<Limit type="Activation" gracePeriod="30" useHardwareLock="True" hardwareId="npG1VxCx5+snErGzA7xBB5Dd9DE=" />
<Limit type="Trial" startDate="2011-03-01" endDate="2011-03-30" />
</Limits>
</License>
Sets the end date for a time limit in a license provided the serial number and the endate in YYYY-MM-DD format. Returns the license content in XML format.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license.
<License>
<SerialNumber>AOF4-DR34-4REW-EW@0-SFT2-4313-DSR3</SerialNumber>
<CreatedDate>2011-01-25</CreatedDate>
<company>SkyXoft</company>
<customer>Jose Leon</customer>
<Limits>
<Limit type="Activation" gracePeriod="30" useHardwareLock="True" hardwareId="npG1VxCx5+snErGzA7xBB5Dd9DE=" />
<Limit type="Trial" startDate="2011-03-01" endDate="2011-03-30" />
</Limits>
</License>
Gets information about a license template.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about the license template.
<LicenseTemplate>
<LicenseTemplateId>23D10086-9D85-43d4-9318-1CA76DE9186F</LicenseId>
<Name>Trial</Name>
<Product>
<Name>Widget App</Name>
</Product>
<ProductVersion>
<Name>Widget App 1.0</Name>
</ProductVersion>
<Properties>
<Name>CustomerName</Name>
</Properties>
<Limits>
<Name>Trial</Name>
<Type>TrialEx</Type>
</Limits>
</LicenseTemplate>
Gets information about all license templates.
The attributes form the XML schema to be sent via the querystring parameter, specifically the data parameter. Fields marked as required should be sent the URL or the function execution will failed.
The method returns the details about all license template.
<LicenseTemplates>
<LicenseTemplate>
<LicenseTemplateId>23D10086-9D85-43d4-9318-1CA76DE9186F</LicenseId>
<Name>Trial</Name>
<Product>
<Name>Widget App</Name>
</Product>
<ProductVersion>
<Name>Widget App 1.0</Name>
</ProductVersion>
<Properties>
<Name>CustomerName</Name>
</Properties>
<Limits>
<Name>Trial</Name>
<Type>TrialEx</Type>
</Limits>
</LicenseTemplate>
</LicenseTemplates>
Morbi quam odio, ultrices a libero sit amet, lacinia commodo quam. Curabitur sodales ornare ex, eu sodales elit venenatis non.
Morbi quam odio, ultrices a libero sit amet, lacinia commodo quam. Curabitur sodales ornare ex, eu sodales elit venenatis non.
Morbi quam odio, ultrices a libero sit amet, lacinia commodo quam. Curabitur sodales ornare ex, eu sodales elit venenatis non.
Morbi quam odio, ultrices a libero sit amet, lacinia commodo quam. Curabitur sodales ornare ex, eu sodales elit venenatis non.
Morbi quam odio, ultrices a libero sit amet, lacinia commodo quam. Curabitur sodales ornare ex, eu sodales elit venenatis non.
Morbi quam odio, ultrices a libero sit amet, lacinia commodo quam. Curabitur sodales ornare ex, eu sodales elit venenatis non.