Get user by ID or username

GET

https://cdn.emnify.net/api/v1/user/:user_id

GET

/api/v1/user/:user_id

$ curl https://cdn.emnify.net/api/v1/user/1.1 \
>      -H "Authorization: Bearer <token>"

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 user by ID or username

Get user by ID or username

Authentication

Path parameters

Response

Errors

Authentication

Path parameters

Response

Errors

$	curl https://cdn.emnify.net/api/v1/user/1.1 \
>	-H "Authorization: Bearer <token>"

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	}