Checking Device Code

In this article

    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

    }