# API call to unmask all emails

**URL:** https://meta.discourse.org/t/api-call-to-unmask-all-emails/71851
**Category:** Feature
**Created:** [October 11, 2017, 3:34pm UTC](https://meta.discourse.org/t/api-call-to-unmask-all-emails/71851 "2017-10-11T15:34:47Z")
**Posts on this page:** 4
**Page:** 1

<div class="post-metadata">

### Author: ![Geoffrey\_Challen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/geoffrey_challen/32/119637_2.png) [@Geoffrey\_Challen](https://meta.discourse.org/u/Geoffrey_Challen)
#### Post date: [October 11, 2017, 3:34pm UTC](https://meta.discourse.org/t/api-call-to-unmask-all-emails/71851/1 "2017-10-11T15:34:47Z")

</div>

In the web interface there is an option for administrators to unmask all emails when examining the active user list. I don’t think that there is an API equivalent, although it would be useful. We have a case where we need to use email addresses as keys to synchronize our user list, and having to unmask each email one at a time generates enough API calls to (quickly) hit the built-in rate limiting.

Apologies if I missed this in the API documentation.

---

<div class="post-metadata">

### Author: ![zogstrip](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/zogstrip/32/512781_2.png) [@zogstrip](https://meta.discourse.org/u/zogstrip)
#### Post date: [October 11, 2017, 3:39pm UTC](https://meta.discourse.org/t/api-call-to-unmask-all-emails/71851/2 "2017-10-11T15:39:15Z")

</div>

While it’s probably not in the API documentation (I haven’t checked), you can open your browser’s console and see the request made when clicking the unmask button as admin.

Then you’ll be able to use that same query in your code 😉

---

<div class="post-metadata">

### Author: ![pfaffman](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pfaffman/32/120154_2.png) [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [October 11, 2017, 3:44pm UTC](https://meta.discourse.org/t/api-call-to-unmask-all-emails/71851/3 "2017-10-11T15:44:38Z")

</div>

> [@zogstrip](#):
>
> While it’s probably not in the API documentation

Here’s the documentation: [Reverse engineer the Discourse API](https://meta.discourse.org/t/how-to-reverse-engineer-the-discourse-api/20576).

---

<div class="post-metadata">

### Author: ![Geoffrey\_Challen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/geoffrey_challen/32/119637_2.png) [@Geoffrey\_Challen](https://meta.discourse.org/u/Geoffrey_Challen)
#### Post date: [October 12, 2017, 1:56pm UTC](https://meta.discourse.org/t/api-call-to-unmask-all-emails/71851/4 "2017-10-12T13:56:51Z")

</div>

Thanks so much guys! It’s working perfectly now.

FWIW, I was passing `show_emails=1` as part of the query string, when what was needed was `show_emails=true`. Perhaps working with JavaScript has spoiled me WRT truthy values, but it would be nice the API was a bit more forgiving 🙂.
