Share via


Announcing new REST APIs in beta for rooms, time zones, and languages

Today we're pleased to announce some new APIs that are available on the beta endpoint for the Outlook REST API. These are currently only available via the Outlook endpoint (https://outlook.office.com/api/beta) and not the Microsoft Graph API endpoint.

Try these new APIs out today, either in your code, or on the Outlook OAuth Sandbox. Leave feedback on these new APIs on UserVoice.

Meeting rooms

One of the top-requested features for the Outlook REST API was the ability to list meeting rooms in an organziation. We've added the ability to find both rooms and room lists.

Get room lists

Request

 GET https://outlook.office.com/api/beta/me/findroomlists

Response

 {
  "value": [
    {
      "Name": "Building 1 Rooms",
      "Address": "Building1Rooms@contoso.onmicrosoft.com"
    },
    {
      "Name": "Building 2 Rooms",
      "Address": "Building2Rooms@contoso.onmicrosoft.com"
    }
  ]
}

Get rooms

Request (all rooms)

 GET https://outlook.office.com/api/beta/me/findrooms

Request (rooms in a room list)

 GET https://outlook.office.com/api/beta/me/findrooms(roomlist='Building1Rooms@contoso.onmicrosoft.com')

Response

 {
  "value": [
    {
      "Name": "Conf Room Adams",
      "Address": "Adams@contoso.onmicrosoft.com"
    },
    {
      "Name": "Conf Room Crystal",
      "Address": "Crystal@contoso.onmicrosoft.com"
    },
    {
      "Name": "Conf Room Stevens",
      "Address": "Stevens@contoso.onmicrosoft.com"
    }
  ]
}

Time zones

The API has support for specifying a time zone via the Prefer header to get back date times in the requested time zone. However, figuring out which time zones are supported has been a little tricky. Now, apps can request a list of all supported time zones from the server, in either Windows or IANA format.

Request

 GET https://outlook.office.com/api/beta/me/SupportedTimeZones(TimeZoneStandard='Windows')

Response

 {
  "value": [
    {
      "Alias": "Dateline Standard Time",
      "DisplayName": "(UTC-12:00) International Date Line West"
    },
    {
      "Alias": "Samoa Standard Time",
      "DisplayName": "(UTC+13:00) Samoa"
    },
    {
      "Alias": "UTC-11",
      "DisplayName": "(UTC-11:00) Coordinated Universal Time-11"
    },
    {
      "Alias": "Aleutian Standard Time",
      "DisplayName": "(UTC-10:00) Aleutian Islands"
    },
    ...
  ]
}

Languages

You can also request a list of supported languages from the server.

Request

 GET https://outlook.office.com/api/beta/me/SupportedLanguages

Response

 {
  "value": [
    {
      "Locale": "af-ZA",
      "DisplayName": "Afrikaans (Suid-Afrika)"
    },
    {
      "Locale": "am-ET",
      "DisplayName": "አማርኛ (ኢትዮጵያ)"
    },
    {
      "Locale": "ar-AE",
      "DisplayName": "العربية (الإمارات العربية المتحدة)"
    },
    {
      "Locale": "ar-BH",
      "DisplayName": "العربية (البحرين)"
    },
    ...
  ]
}