Get Alternate CSS URL of SharePoint site using REST API

This blog contains the syntax and code snippet to retrieve the alternate css url of a SharePoint site using REST API.

Syntax

REST API Endpoint:

https://SharePointSiteURL/_api/web?$select=AlternateCssUrl

REST API endpoint to use in Add-ins:

<appweburl>/_api/SP.AppContextSite(@target)/web?$select=AlternateCssUrl&@target=<hostweburl>

Embed Code Snippet

The following code snippet can be added to SharePoint page or in content editor web part as a script. This example is used to get the alternate css URL of a SharePoint site. 

<script type="text/javascript" src="/SiteAssets/Scripts/jquery.min.js"></script>
<script type="text/javascript">
    $.ajax(
    {
        url: _spPageContextInfo.webAbsoluteUrl + "/_api/web?$select=alternatecssurl", //THE ENDPOINT
        method: "GET",
        headers:
        {
            "Accept": "application/json; odata=verbose"
        },
        success: function(data)
        {
            //RESULTS HERE!!
            console.log('Alternate Css URL: ' + data.d.AlternateCssUrl)
            alert('Alternate Css URL: ' + data.d.AlternateCssUrl);

        }
    });
</script>

 Add-in Code Snippet

The following code snippet is used in SharePoint Add-in to get the alternate css URL of a SharePoint site. 

// Load the js files and continue to the successHandler
$.getScript(scriptbase + "SP.RequestExecutor.js", execCrossDomainRequest);

// Function to prepare and issue the request to get
// SharePoint data
function execCrossDomainRequest()
{
    // Initialize the RequestExecutor with the add-in web URL.
    var executor = new SP.RequestExecutor(appweburl);
    // Issue the call against the add-in web.
    // To get the AlternateCssUrl property using REST we can hit the endpoint:
    // appweburl/_api/web?select=AlternateCssUrl&@target=hostweburl
    // The response formats the data in the JSON format.
    executor.executeAsync(
    {
        url: appweburl + "/_api/SP.AppContextSite(@target)/web?$select=alternatecssurl&@target='" + hostweburl + "'",
        method: "GET",
        headers:
        {
            "Accept": "application/json; odata=verbose"
        },
        success: successHandler,
        error: errorHandler
    });
}
// Function to handle the success event.
function successHandler(data)
{
    var jsonObject = JSON.parse(data.body)
    //jsonObject.d.AlternateCssUrl returns the server relative url of alternative css configured in SharePoint site
    console.log('Alternate Css URL: ' + jsonObject.d.AlternateCssUrl)
    alert('Alternate Css URL: ' + jsonObject.d.AlternateCssUrl);
}

function errorHandler(data, errorCode, errorMessage)
{
    console.log("Could not complete cross-domain call: " + errorMessage);
}