Blog Post

Surface IT Pro Blog
2 MIN READ

Introducing the Surface API Management Service

rohitmannan's avatar
rohitmannan
Icon for Microsoft rankMicrosoft
Apr 13, 2024

Our goal is to support our customers' needs, wherever they might be. To this end, we're introducing the Surface API Management Service, aimed at simplifying how you access information about your devices, coverage and insights.

 

Extend Surface Management Portal

This service builds on the familiar Surface Management Portal, enabling IT admins to directly access Microsoft coverage and entitlement information for their devices via API endpoints. It's a practical enhancement for those already using the portal, designed to make device management more straightforward.

 

The service at a glance

The Surface API Management Service is an API management system that allows you to gain access to APIs that provide you with information about your devices. 

 

These APIs serve as a direct conduit for customers seeking to streamline their asset management processes. By seamlessly connecting to the API, IT admins gain immediate access to critical device and warranty information, essential for effective asset oversight. Tailored specifically for Surface customers, this integration offers a hassle-free solution, eliminating the need for convoluted data acquisition methods. Now, with the simple integration of this API, customers can quickly retrieve pertinent details, empowering organizations to make informed decisions and optimize their asset management strategies.

 

Our first launch experience will allow current Surface Management Portal users to get their Microsoft coverage and entitlement information for their devices directly through API endpoints. Through our portal you can also see more of the performance and usage of the APIs across the globe with Surface API Management Service Reports.

 

 

Get access to Surface API Management Services

To access, you need an active Surface Management Portal Account and a completed customer validation check. (If you have access to create service requests within Surface Management Portal you have been approved.)

 

Email request to surfaceapimanagement@microsoft.com

Subject: “Requesting Access to Surface API Management Service”

Include the following info:

  • Company Name
  • Tenant ID
  • Tenant primary domain (e.g. contoso.onmicrosoft.com)
  • Application (client) ID*
  • Estimated quantity of Intune-registered Surface devices in your organization

 

Get started

To get started with using the APIs, see the Readme on GitHub.

Updated Apr 13, 2024
Version 1.0
  • fulcra-cp's avatar
    fulcra-cp
    Copper Contributor

    Can we register as partners to get access to all of the tenants that we manage via GDAP?

    We sell and manage the Surfaces but have a gap in our ability to monitor the warranty status of the fleet. This would be extremely helpful (if not crucial) to our success as a Microsoft partner and reseller.

  • Hi,

    Thank you for your question. Pulling the device information is linked with the Customer ID which is associated with Azure tenant. If you are managing all your customer with one account- yes this can help you pull the information.

    But if every customer have their own tenant - then you need to gather the details of each tenant and customer Id and submit individual request for access.

    I hope it answers your question.

     

    Thanks

    Rohit

  • blighter's avatar
    blighter
    Copper Contributor

    Hey! How long do these take to process? Keen to get started but have been waiting for access for a couple of weeks. Thanks!