# Is there any documentation on the User/Mobile API?

**URL:** https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081
**Category:** Support
**Created:** [June 25, 2017, 5:18am UTC](https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081 "2017-06-25T05:18:23Z")
**Posts on this page:** 5
**Page:** 1

<div class="post-metadata">

### Author: ![evaryont](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/evaryont/32/122402_2.png) [@evaryont](https://meta.discourse.org/u/evaryont)
#### Post date: [June 25, 2017, 5:18am UTC](https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081/1 "2017-06-25T05:18:23Z")

</div>

I was looking at the [Discourse Mobile app source code](https://github.com/discourse/DiscourseMobile) and noticed it using the user API keys, and calling `/user-api-key/new` but I don’t see any reference to that in the Discourse API documentation. Are the routes documented anywhere beyond the source code?

And, how do users from SSO get their own API key? Most documentation that I find mention getting the API key from the admin panel, but that won’t work for me. I’d like to get a list of notifications from here, on meta, and other instances of discourse where I’m just a user. Similar to what the mobile app does already, but I’d like to use the information in a different context.

---

<div class="post-metadata">

### Author: ![j.jaffeux](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/j.jaffeux/32/60297_2.png) [@j.jaffeux](https://meta.discourse.org/u/j.jaffeux)
#### Post date: [June 26, 2017, 10:06am UTC](https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081/2 "2017-06-26T10:06:04Z")

</div>

The `HEAD /user-api-key/new` request you are seeing is not creating anything, it’s mostly to check the site exists and it has the correct auth API version.

As you can see if it’s a HEAD request we are returning early: [discourse/app/controllers/user\_api\_keys\_controller.rb at main · discourse/discourse · GitHub](https://github.com/discourse/discourse/blob/master/app/controllers/user_api_keys_controller.rb#L13)

On the mobile app auth is done with an `authToken` coming back from the site popup when you tap on `authorize` see: [DiscourseMobile/js/site\_manager.js at main · discourse/DiscourseMobile · GitHub](https://github.com/discourse/DiscourseMobile/blob/master/js/site_manager.js#L437)

Concerning the notifications, the documentation is here: [Discourse API Docs](http://docs.discourse.org/#tag/Notifications%2Fpaths%2F~1notifications.json%2Fget) (I do agree it’s probably incomplete, you might want to grep DiscourseMobile code for “/notifications”)

---

<div class="post-metadata">

### Author: ![system](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/system/32/443519_2.png) [@system](https://meta.discourse.org/u/system)
#### Post date: [June 22, 2019, 12:41am UTC](https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081/3 "2019-06-22T00:41:04Z")

</div>



---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [June 25, 2019, 12:47am UTC](https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081/4 "2019-06-25T00:47:15Z")

</div>

Current docs are at [User API keys specification](https://meta.discourse.org/t/user-api-keys-specification/48536)

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [June 25, 2019, 12:47am UTC](https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081/5 "2019-06-25T00:47:19Z")

</div>


