NMM Distributor API - examples

Applies to: Nerdio Manager for MSP (NMM) Distributors

Available in v1.1.0+

This KB lists examples of some common API calls and responses.

/register

Claim a MSP partner's existing and future NMM installs in their Azure Subscription. This API is typically used when partner purchases NMM in your portal.

Example #1

A positive use-case, the typical flow when you have fed all the right values to the API call and get a 200 response since the API call was successful.

Example #2

A positive use-case, the typical flow when you have fed all the right values to the API call and get a 200 response since the API call was successful. This example shows the response when a partner has multiple Installs of NMM in the same Azure subscription. While this is a rare use-case, program your end to absorb multiple InstallIDs.

Example #3

A negative use-case, API response when NMM Installs are already claimed by another distributor.

Example #4

A negative use-case, API response when the APIKey is incorrect.

/invoices

Collect invoice information. This API is typically used for monthly billing.

Example #1

A positive use-case, the typical flow when you have fed all the right values to the API call and get a 200 response since the API call was successful.

Download the attached JSON file for the entire response. Scroll down to bottom of KB article and look for file named "response_usage.json".

A few things to note about the /usage API and response:

1. Period start and end dates must be in the mm/dd/yyyy format.
2. The response matches the invoice you see in the Mothership portal:
   
   
   Nerdio Tip For the best understanding of the API response JSON, view the invoice in the Mothership portal first.
    
3. Note the Type column in the invoice. Type indicates if line item is a chargeable item or a discount.
   
   
   
4. The possible values for Type are:
   1. AVD users: number of end-users that are assigned an AVD desktop, averaged out over the calendar month.
      
   2. Cloud PC-only users: number of end-users that are assigned a Windows 365 Cloud PC but not a AVD desktop, averaged out over the calendar month.
      
   3. Discount: a reduction in cost applied to an account or partner (install) or distributor.
   4. Price control: a floor or ceiling applied to an account, partner or distributor. For example, Nerdio may have an arrangement with a partner to charge a minimum of $1,000 per month. That would be a floor price control. Similarly, Nerdio may have an arrangement to charge a maximum of $50,000 per month with a different partner. That would be a ceiling price control.
   5. Upcharge: generally these are charges for services besides AVD and Cloud PC licenses. They are applied to the invoice overall (not at the individual account or install level). These entries are rare and listed here only to make you aware.

Example #2

A negative use-case, API response when usage information is not available for the specified period.

Note: the response code is a 200 and the response body is empty.

Example #3

A negative use-case, API response when date range is incorrect.

/reactivate

Unsuspend all installs in an Azure subscription. This API is typically used to remove the temporary halt for non-payment.

Example #1

A positive use-case, the typical flow when you have fed all the right values to the API call and get a 200 response since the API call was successful.

{ "subscriptionId": "ae51ae63-XXXXX-XXXXX-XXXX-0c7a1c93d3f2", "installIDs": [ "fcXXXXXXXXXXXX5068e5e7a" ] }

Example #2

A negative use-case, showcases the API response when you provide an incorrect value for a parameter.