Get usages for a feature within an organization - requires view access to billing

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Accept: application/json

RESPONSE
200 (Ok)
{
  "feature_usages": [
    {
      "id": 1,
      "organization_id": 9001,
      "feature_id": 55,
      "consumable_id": 2,
      "consumable_type": "Organization",
      "amount": 1,
      "user_id": 5001,
      "created_at": 1392405501,
      "updated_at": 1392405501
    },
      "id": 2,
      "organization_id": 9001,
      "feature_id": 55,
      ...
    }
  ]
  "summary": {
    "page": 1,
    "per_page": 2,
    "count": 4
  }
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String

user_ids
optional , nil allowed

A list of user_ids to select usages from

Validations:

  • Must be an array of any type