Version 2021
Get user information
Returns information about the user logging in with Badge. For example, you can retrieve user information to display on the user's smartphone after she logs in with Badge. Your third-party mobile app makes this call against your third-party mobile server.
This API call is optional, and the specific details below are provided as an example. You can choose to implement this API call differently depending on your mobile server configuration.
Request format
HTTP method
GET
HTTP header
The cookie indicating the session that was created between the third-party mobile app and the third-party mobile server (see Request session between third-party server and third-party app).
Resource URL
https://
mobileServer
/userInfo
Parameters
Parameter | Required? | Description |
mobileServer
|
Required | The location of your third-party mobile server. |
Response format
Response body
{
"first_name": "...",
"last_name": "...",
"first_name": "...",
"photo": "...",
"title": "...",
"badge_id": "...",
"email": "...",
}
Example
Example request
curl -i "https://acmecorp.com/userInfo" -H "Cookie: JSESSIONID=TpYsSXRkUZRs-Z_3fl--amZ7ycx0kLm:853449:_3436"
Example response
{
"first_name": "Jane",
"last_name": "Doe",
"photo":"AQAAAHQAAAD9////+wUAAG0AAABaBgAAov///+S6AABODQAAfcYAACBFTUYAAAEAAAQAACsAAAAEAAAADQAAAFgAAAAAAAAAAAQAAAADAABAAQAA8AAAAEEAZABvAGIAZQAgAFMAeQBzAHQAZQBtAHMAAAARAAAADAAAAAgAAAASAAAADAAAAAEAAAAKAAAAEAAAAAAAAAAAAAAADAAAABAAAAAAAAAAAAAAAAkAAAAQAAAAcAAAAF8AAAALAAAAEAAAAHAAAABfAAAAEwAAAAwAAAACAAAAJwAAABgAAAABAAAAAAAAAAue2gAAAAAAJQAAAAwAAAABAAAAXwAAADQAAAACAAAALAAAAAAAAAAsAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACUAAAAMAAAAAgAAADsAAAAIAAAAGwAAABAAAABOAAAAJgYAAFgAAABkAAAAHAAAABgGAABvAAAATgYAABIAAABfACoGawA5BmsATAZtAEwGbQBMBm0ATAZLAEwGSwBMBksATAYhAEwGIQBMBiEATAYhAEwGHgAfBj0AHAZcABoGTgAmBk4AJgY9AAAACAAAADwAAAAIAAAAPgAAABgAAACfhgEAn4YBAGF5/v9hef7/EwAAAAwAAAACAAAAOwAAAAgAAAAbAAAAEAAAAC8AAAALBgAAWAAAAEwAAAAwAAAA+QUAAF0AAAAqBgAADAAAADIAAgY7APsFRQD7BVEA+wVbAAUGWwASBlsAHgZRACgGRQAoBkIAKAY/ACcGPAAmBjwAAAAIAAAAPgAAABgAAACfhgEAn4YBAGF5/v9hef7/EwAAAAwAAAACAAAAJwAAABgAAAADAAAAAAAAAEFBQgAAAAAAJQAAAAwAAAADAAAAKAAAAAwAAAABAAAAOwAAAAgAAAAbAAAAEAAAAD0AAAAgBgAAWAAAAEwAAAAPAAAACAYAAD8AAAA4BgAADAAAAD0ALAYzADYGJwA2BhsANgYRACwGEQAgBhEAFAYbAAoGJwAKBjMACgY9ABQGPQAgBj0AAAAIAAAAPAAAAAgAAAA+AAAAGAAAAJ+GAQCfhgEAYXn+/2F5/v8TAAAADAAAAAIAAAA7AAAACAAAABsAAAAQAAAAMQAAADQGAABYAAAAWAAAAPv///8yBgAAUgAAAFwGAAAPAAAAQQA5Bk0ASAZNAFoGUABaBlAAWgZQAFoG/f9aBv3/Wgb9/1oGAABaBgAAWgYAAFoGAABIBgwAOAYdADQGPAAAAAgAAAA+AAAAGAAAAJ+GAQCfhgEAYXn+/2F5/v8oAAAADAAAAAIAAAAoAAAADAAAAAMAAAAOAAAAFAAAAAAAAAAQAAAAFAAAA==",
"title": "Director of Operations",
"badge_id": "12345",
"email": "jdoe@example.com",
}