diff -r 000000000000 -r 6474c204b198 dom/voicemail/nsIDOMMozVoicemailStatus.idl
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/dom/voicemail/nsIDOMMozVoicemailStatus.idl	Wed Dec 31 06:09:35 2014 +0100
@@ -0,0 +1,47 @@
+/* -*- Mode: c++; c-basic-offset: 2; indent-tabs-mode: nil; tab-width: 40 -*- */
+/* vim: set ts=2 et sw=2 tw=40: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this file,
+ * You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#include "nsISupports.idl"
+
+[scriptable, uuid(efd352af-9eee-48dc-8e92-4d4fdbc89ecb)]
+interface nsIDOMMozVoicemailStatus : nsISupports
+{
+  readonly attribute unsigned long serviceId;
+
+  /**
+   * Whether or not there are messages waiting in the voicemail box
+   */
+  readonly attribute boolean hasMessages;
+
+  /**
+   * The total message count. Some voicemail indicators will only specify that
+   * messages are waiting, but not the actual number. In that case, the value
+   * of messageCount will be -1, indicating the unknown message count.
+   *
+   * Logic for a voicemail notification might look something like:
+   * if (status.hasMessages) {
+   *   // show new voicemail notification
+   *   if (status.messageCount > 0) {
+   *     // add a label for the message count
+   *   }
+   * } else {
+   *   // hide the voicemail notification
+   * }
+   */
+  readonly attribute long messageCount;
+
+  /**
+   * Return call number received for this voicemail status, or null if one
+   * wasn't provided.
+   */
+  readonly attribute DOMString returnNumber;
+
+  /**
+   * Displayable return call message received for this voicemail status, or null
+   * if one wasn't provided.
+   */
+  readonly attribute DOMString returnMessage;
+};