Account - Usage Statements API

Note: you must be account owner to access this API.

List Usage Statements

List all usage statements:

GET /account/usage_statements

Response

Status: 200 OK
[
  {
    "id": 1280,
    "plan": "premium_plus",
    "year": 2015,
    "month": 10,
    "start_date": "2015-10-24",
    "end_date": "2015-10-31",
    "user_months": 3
  },
  {
    "id": 1432,
    "plan": "premium_plus",
    "year": 2015,
    "month": 11,
    "start_date": "2015-11-01",
    "end_date": "2015-11-30",
    "user_months": 12
  },
  "..."
]

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

Collection Fields

By default the following fields will appear collections of usage statements:

end_date id month plan start_date user_months year

Obtain a different set of fields using the ?fields= parameter.

Filtering

Filtering is available for the following fields:

id year month

Sorting

By default a collection of usage statements is sorted descending by id.

Get a Usage Statement

GET /account/usage_statements/:id

The following can be used to get the usage statement for October 2015:

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

Response

Status: 200 OK
{
  "billable_user_ids": [
    1205,
    1206,
    1207,
    1208,
    1209,
    1210,
    1211,
    1212,
    1275,
    1267,
    1271,
    1264
  ],
  "end_date": "2015-11-30",
  "id": 1432,
  "month": 11,
  "plan": "premium_plus",
  "start_date": "2015-11-01",
  "user_months": 12,
  "year": 2015
}

The response contains these fields.

Fields

billable_user_ids
Readonly array of references to Person — The IDs of the Person records that are registered in the account and which were enabled and had a role (other than End User or Key Contact) at any time between the start date and the end date.
end_date
Readonly date — The date on which the billing period ended.
id
Readonly integer — The unique ID of the usage statement.
month
Readonly integer — The month for which the usage statement was generated.
plan
Readonly enum — The Plan field is used to select the Plan for the account. Valid values are:
  • basic
  • premium
  • premium_plus
start_date
Readonly date — The date on which the billing period started.
user_months
Readonly integer — The number of Person records that are registered in the account and which were enabled and had a role (other than End User or Key Contact) at any time between the start date and the end date.
year
Readonly integer — The year for which the usage statement was generated.