Obtaining the Internal Identifier of a Microsoft Account

In some cases, you may need to obtain internal identifiers of Microsoft accounts. These internal identifiers are used by the application and differ from Microsoft IDs that are displayed in the Partner Center.

You can obtain the internal identifier of a Microsoft account by following these steps:

1. Prepare the initial subdomain of the Microsoft account.

2. Prepare the APS type identifier of the Tenant APS type.

   Note: To prepare the APS type ID of an APS resource, use the instructions in Obtaining APS Type IDs.

3. Make this request:

   Copy

   GET https://BRAND_DOMAIN/aps/2/resources/?implementing(APS_TYPE_ID_OF_TENANT_RESOURCE),eq(initial_subdomain,INITIAL_SUBDOMAIN_NAME)

   Note: For INITIAL_SUBDOMAIN_NAME, use values without .onmicrosoft.com.

4. From the response that you receive, write down the value of the ms_account_id parameter. This is the internal identifier of the Microsoft account.

Example

HTTP Request

GET https://example.com/aps/2/resources/?implementing(http://www.parallels.com/Office365/Tenant/2.8),eq(initial_subdomain,example)

HTTP Response

[
  {
    "is_activated": "no",
    "aps": {
      "modified": "2020-04-29T04:00:49Z",
      "id": "c70c20f9-614e-4c9e-9ca2-72594b9056ca",
      "subscription": "6e40eb10-4d4e-4cbb-a8b8-953808650eee",
      "type": "http://www.parallels.com/Office365/Tenant/2.8",
      "status": "aps:provisioning",
      "revision": 890
    },
    "ms_account_id": "4188e387-a418-40f0-9166-54295cab3fcc",
    "initial_subdomain": "example",
    "totalPointsSold": {
      "limit": -1
    },
    "totalSeatsSold": {
      "limit": -1
    }
  },
  {
    "is_activated": "activating",
    "aps": {
      "modified": "2020-06-23T03:39:43Z",
      "id": "d4cf0ea9-8f44-41c7-80da-1766174a4b12",
      "subscription": "c31ae77d-27e2-402b-9ae8-41acb08e881e",
      "type": "http://www.parallels.com/Office365/Tenant/2.8",
      "status": "aps:provisioning",
      "revision": 1070
    },
    "ms_account_id": "4188e387-a418-40f0-9166-54295cab3fcc",
    "initial_subdomain": "example",
    "cloud_agreement_contact": {
      "date_agreed": "2020-02-19",
      "phone": "+1234567",
      "last_name": "Smith",
      "first_name": "John",
      "email": "johnsmith@example.com"
    },
    "totalPointsSold": {
      "limit": -1
    },
    "totalSeatsSold": {
      "limit": -1
    }
  }
]