This is an archive version of the document. To get the most up-to-date information, see the current version.

Checking Device Code

You can check whether a device code was used to sign in to the Microsoft authentication portal.

Request

POST https://<hostname>:4443/v6/DeviceCode/check

Request Headers

The request header must contain an authorization token of the current session.

Request Body

The request body must contain the following properties:

Property

Type

Description

userCode

string

Specifies the device code that you want to check whether it was used to sign in to the Microsoft authentication portal.

Request Example

Request:

POST https://abc.tech.local:4443/v6/DeviceCode/check

 

Request Header:

Authorization: Bearer <Access-Token>

Request Body:

{

 "userCode": "DLSJ93K8Q"

}

Response

The server returns the following response to the client.

Response Codes

A successfully completed operation returns a response code 200 OK.

Response Headers

The response to this request contains the following headers. The response may also include additional standard HTTPS headers.

Header

Description

Content-length

The length of the response body.

Content-type

The media type and syntax of the response body message: application/json; charset=utf-8

Response Body

The response body contains the following properties:

Property

Type

Description

authenticated

boolean

If set to true, indicates that the device code was used to sign in to the Microsoft authentication portal.

Response Example

Response:

200 OK

 

Response Body:

{

 "authenticated": true

}