List users for an account. | Invofox

const url = 'https://api.invofox.com/users?account=28b05b800123456789000000&environment=000000000000000000000001&limit=50';
const options = {method: 'GET', headers: {'x-api-key': '<apiKey>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "count": 1,
  "result": [
    {
      "_id": "28b05b800123456789000000",
      "account": "28b05b800123456789000000",
      "creator": "28b05b800123456789000000",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "lang": "en",
      "creation": "2024-01-15T09:30:00Z",
      "verifiedAt": "2024-01-15T09:30:00Z",
      "lastAccessAt": "2024-01-15T09:30:00Z",
      "remote": true,
      "roles": [
        {
          "_id": "28b05b800123456789000000",
          "user": "28b05b800123456789000000",
          "scope": "account",
          "account": "28b05b800123456789000000",
          "environment": "000000000000000000000001",
          "role": "accountAdmin",
          "createdAt": "2024-01-15T09:30:00Z",
          "createdBy": "28b05b800123456789000000"
        }
      ]
    }
  ]
}

Lists the users that have a role in an account, or in one of its environments.

Permissions: with environment, the caller needs the envDev role or higher on that environment.

API keys: environment is required. An API key always acts as envDev on the environment it belongs to, so it can only list that environment. Without environment it gets 403.
Dashboard users: without environment, the caller needs accountAdmin on the account; otherwise the API answers 403.

Pagination: results are paginated. If you don’t send limit, only the first 50 users are returned. Use count to know the total and page with skip and limit. There is no maximum limit.

Filters are plain query parameters (?environment=...&limit=100), not a JSON filter object.

Authentication

x-api-keystring

API Key authentication via header

Query parameters

accountstringOptional

Account to list users for. Defaults to the caller's account.

environmentstringOptional

Only list users with access to this environment: users with a role on the environment, plus account admins. Required when calling with an API key, and it must be the environment the key belongs to.

roleenumOptional

Only list users with this role. Any other value answers 400.

Allowed values:

sortstringOptional

Field to sort users by. Prefix with - for descending order (e.g., -creation for newest first). Without it, the order is not guaranteed.

skipintegerOptional>=0Defaults to 0

(List pagination element) number of users to skip from the start of the list.

limitintegerOptional>=1Defaults to 50

(List pagination element) number of users to return, starting at skip. Defaults to 50. There is no maximum. 0 or a non-numeric value returns an empty result.

Response

A list of users. count is the total number of matching users, not the number returned in result.

countintegerOptional

resultlist of objectsOptional

Errors

403

Forbidden Error