Get user by ID or username | emnify Documentation

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

{
  "id": 123,
  "username": "eabbot@flatland.org",
  "name": "Edwin Abbott",
  "created": "2019-08-31T16:47:00.000Z",
  "status": {
    "id": 1,
    "description": "Active"
  },
  "organisation": {
    "id": 123,
    "name": "Company"
  },
  "roles": [
    {
      "id": 2,
      "name": "User"
    },
    {
      "id": 3,
      "name": "Observer"
    }
  ],
  "mfa": [
    {
      "id": 12,
      "type": {
        "id": 0,
        "name": "Time-Based One-Time Password"
      },
      "status": {
        "id": 1,
        "name": "Active"
      },
      "creation_date": "2017-02-03T14:04:03.000Z",
      "activation_date": "2017-02-04T09:14:13.000Z"
    }
  ]
}

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

usernamestring

namestring

createdstring

statusobject

organisationobject

roleslist of objects

mfalist of objects

Errors

404

Not Found Error