Account - Billable Users API

List Billable Users

List all current billable users of an account:

GET /account/billable_users

Response

Status: 200 OK
[
  {
    "id": 552,
    "primary_email": "abbie.lindt@microsoft.com",
    "name": "Abbie Lindt",
    "organization": "Microsoft Corporation",
    "business_unit": null,
    "sign_ins": 0,
    "last_visit": null,
    "updates": 0
  },
  {
    "id": 70,
    "primary_email": "ashok.kumar@virtualsupport.com",
    "name": "Ashok Kumar",
    "organization": "Widget Data Center, External IT",
    "business_unit": "Widget Data Center",
    "sign_ins": 14,
    "last_visit": "2015-10-30T15:22:25-05:00",
    "updates": 78
  },
  "..."
]

The response contains these fields by default. Filtering and pagination are available to reduce/limit the collection of usage statements.

Filtering

Filtering is available for the following fields:

id year month

To obtain all billable users of an account for a previous month (e.g. October 2015):

GET /account/billable_users?year=2015&month=10

To retrieve the same billable users as a list of comma-separated values (CSV):

GET /account/billable_users.csv?year=2015&month=10

Fields

account
Readonly reference to Account — The account of the person.
business_unit
Readonly string (max 128) — The Business unit field shows the name of the business unit that the person’s organization belongs to.
id
Readonly integer — The unique ID of the person.
last_visit
Readonly datetime — The date and time at which the person last accessed the 4me service.
name
Required string (max 128) — The Name field is used to enter the person’s name.
organization
Required string (max 128) — The Organization field shows the name of the organization that the person belongs to.
primary_email
Readonly string (max 128) — The Primary email field is used to enter the email address to which email notifications are to be sent. This email address acts as the unique identifier for the person within the 4me account. This primary email address also acts as the person’s login name if he/she is a user of the 4me service.
region
Readonly string (max 128) — The Region field shows the name of the region of the person’s organization.
sign_ins
Readonly integer — The total number of times to date that the person has signed into the 4me service.
updates
Readonly integer — The number of record updates the person made in the given month through using the UI acting to support.