The Users API provides a simple interface to your account’s users. The API provides read-only access, where you can retrieve a single user as well as list of all users associated with your account.

When you sign up with Base, we create a single master account and a single user with account management privileges. By logging in as the account manager, you can create as many additional users as you need.


Attribute Description
id number readonly

Unique identifier of the user.

name string

Full name of the user.

email string

Email address of the user.

status string readonly

Status of the user’s account. Usually active.

Possible values:

  • active
  • inactive
invited boolean readonly

Indicates whether an invitation has been sent to the user or not. Usually true.

confirmed boolean readonly

Indicates whether the user’s account has been confirmed or not.

phone_number string

Contact phone number of the user.

role string readonly

Role of the user. Notice that this attribute has no connection with role based access control and permissions. It indicates whether the user is an admin or a regular user.

Possible values:

  • user
  • admin
roles array

An array of roles assigned to the user. Each entry in the array includes a unique identifier of the role and it’s name. You can expect unique values in the array. RBAC API is not yet public.

team_name string readonly

Name of the team the user belongs to.

group object readonly

Group the user belongs to. The group entry includes a unique identifier and a name.

reports_to number readonly

Unique identifier of the manager of the user.

timezone string

Timezone of the user as the offset from Coordinated Universal Time (UTC) in the format UTC(+|-)[hh]:[mm]. Fallbacks to the account’s timezone if not set per user.

created_at string readonly

Date and time of creation in UTC (ISO8601 format).

updated_at string readonly

Date and time of the last update in UTC (ISO8601 format).

deleted_at string readonly

Date and time of deletion in UTC (ISO8601 format) in case the user has been deleted.


Retrieve all users

Returns all users, according to the parameters provided.


Attribute Description
page number optional

Page number to start from. Page numbering starts at 1, and omitting the page parameter will return the first page.

e.g. ?page=2
per_page number optional

Number of records to return per page. The default limit is 25, and the maximum number that can be returned is 100.

e.g. ?per_page=20
sort_by string optional

A field to sort by. The default order is ascending. If you want to change the sort order to descending, append :desc to the field e.g. sort_by=name:desc.

Possible values:

  • id
  • name
  • created_at
  • updated_at
e.g. ?sort_by=created_at
ids string optional

Comma-separated list of user IDs to be returned in a request.

e.g. ?ids=1,2,3
name string optional

Name of the user. This parameter is used in a strict sense.

e.g. ?name=Mark%20Johnson
email string optional

Email of the user. This parameter is used in a strict sense.

e.g. ?
role string optional

Role of user to search for.

e.g. ?role=admin
role_id number optional

The unique identifier of the role.

e.g. ?role_id=2
status string optional

Status of user accounts to search for.

Possible values:

  • active
  • inactive
e.g. ?status=active
confirmed boolean optional

Indicator whether to return only confirmed user accounts or not.

e.g. ?confirmed=true

Retrieve a single user

Returns a single user according to the unique user ID provided. If the specified user does not exist, this query returns an error.


Attribute Description
id number required

Unique identifier of the user.

Retrieve an authenticating user

Returns a single authenticating user, according to the authentication credentials provided.