Get user by ID or username | emnify Documentation

1 import requests 2 3 url = "https://cdn.emnify.net/api/v1/user/1.1" 4 5 headers = {"Authorization": "Bearer <token>"} 6 7 response = requests.get(url, headers=headers) 8 9 print(response.json())

1 { 2 "id": 123, 3 "username": "eabbot@flatland.org", 4 "name": "Edwin Abbott", 5 "created": "2019-08-31T16:47:00.000Z", 6 "status": { 7 "id": 1, 8 "description": "Active" 9 }, 10 "organisation": { 11 "id": 123, 12 "name": "Company" 13 }, 14 "roles": [ 15 { 16 "id": 2, 17 "name": "User" 18 }, 19 { 20 "id": 3, 21 "name": "Observer" 22 } 23 ], 24 "mfa": [ 25 { 26 "id": 12, 27 "type": { 28 "id": 0, 29 "name": "Time-Based One-Time Password" 30 }, 31 "status": { 32 "id": 1, 33 "name": "Active" 34 }, 35 "creation_date": "2017-02-03T14:04:03.000Z", 36 "activation_date": "2017-02-04T09:14:13.000Z" 37 } 38 ] 39 }

Get a specific user by ID provided the user is within this requesting user’s organisation or the organisation’s immediate child organisations.

id may be one of:

The numeric ID of the user, e.g. “123”. This is the top-level id object returned by each item in GET /api/v1/user
Username (email), e.g. “exampleuser@org.de”. This is the top-level username object returned by each item in GET /api/v1/user

Get a specific user by ID provided the user is within this requesting user's organisation or the organisation's immediate child organisations. `id` may be one of: * The numeric ID of the user, e.g. "123". This is the top-level `id` object returned by each item in `GET /api/v1/user` * Username (email), e.g. "exampleuser@org.de". This is the top-level `username` object returned by each item in `GET /api/v1/user`

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Path parameters

user_iddoubleRequired

User ID

Response

Success

idinteger or null

usernamestring or null

namestring or null

createdstring or null

statusobject or null

organisationobject or null

roleslist of objects or null

mfalist of objects or null

Authentication

Path parameters

Response

Errors