Get user information

Reviewed on September 18, 2026 · View on GitHub

You can find all the basic information about a user, including the state of their account in the system.

Permissions

info

This action requires the following IAM (Identity and Access Management) permissions:

• iam.user.get

Console

Console

1 / 4From the left-hand side menu, click IAM → Users.

1 / 4

1. In the Users table, click the identifier of the user whose information you want to retrieve.

tip

You can search for a specific user using the Search field.

2. The "User details" page is displayed, with the user's general information: first name, last name, email and account status.

3. You can also view the list of spaces assigned to the user, as well as the roles and permissions assigned to them for a given space.

4. Clicking X roles displays the list of roles assigned to the user on one of the spaces they are associated with.

5. Clicking X permissions displays the list of permissions assigned to the user on one of the spaces they are associated with.

API

API

Get the details of a user in an organisation

https://docs.numspot.com/openapi/#tag/identity-access-management/GET/iam/organisations/{organisationId}/users/{userId}

Example

curl 'https://api.{region}.numspot.com/iam/organisations/{organisationId}/users/{userId}'

Response

{
  "email": "john.smith@acme.org",
  "firstname": "…",
  "lastname": "…",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "active": true,
  "createdOn": "2018-11-13T20:20:39+00:00",
  "updatedOn": "2018-11-13T20:20:39+00:00"
}

info

See the API usage page for details.

Get the details of a user in a space

https://docs.numspot.com/openapi/#tag/identity-access-management/GET/iam/spaces/{spaceId}/users/{userId}

Example

curl 'https://api.{region}.numspot.com/iam/spaces/{spaceId}/users/{userId}'

Response

{
  "email": "john.smith@acme.org",
  "firstname": "…",
  "lastname": "…",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "active": true,
  "createdOn": "2018-11-13T20:20:39+00:00",
  "updatedOn": "2018-11-13T20:20:39+00:00"
}

info

See the API usage page for details.

Get the list of spaces assigned to a user

https://docs.numspot.com/openapi/#tag/identity-access-management/GET/iam/organisations/{organisationId}/users/{userId}/spaces

Example

curl 'https://api.{region}.numspot.com/iam/organisations/{organisationId}/users/{userId}/spaces'

Response

{
  "nextPageToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
  "totalSize": 150,
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

info

See the API usage page for details.

Get the roles and permissions of a user account in an organisation

https://docs.numspot.com/openapi/#tag/identity-access-management/GET/iam/organisations/{organisationId}/iampolicy/{subjectType}/{subjectId}

Example

curl 'https://api.{region}.numspot.com/iam/organisations/{organisationId}/iampolicy/{subjectType}/{subjectId}'

Response

{
  "roles": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "permissions": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

info

See the API usage page for details.

Get the roles and permissions of a user account in a space

https://docs.numspot.com/openapi/#tag/identity-access-management/GET/iam/spaces/{spaceId}/iampolicy/{subjectType}/{subjectId}

Example

curl 'https://api.{region}.numspot.com/iam/spaces/{spaceId}/iampolicy/{subjectType}/{subjectId}'

Response

{
  "roles": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "permissions": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

info

See the API usage page for details.

Terraform

Terraform

The Terraform documentation is available on the Numspot registry ↗.