BObox
Terms of service user statuses

List terms of service user statuses

Changed on

Retrieves an overview of users and their status for a terms of service, including Whether they have accepted the terms and when.

get/terms_of_service_user_statuses

Request

  • Base URL
    https://api.box.com/2.0
  • URL
    https://api.box.com/2.0/terms_of_service_user_statuses
  • Auth
    OAuth 2
    Authorization code: https://account.box.com/api/oauth2/authorize
    Token URL: https://api.box.com/oauth2/token

Query parameters

tos_idstring required

The ID of the terms of service.

user_idstring

Limits results to the given user ID.

Response

Returns a list of terms of service statuses.

total_countinteger

The total number of objects.

Example response

{
  "total_count": 2,
  "entries": [
    {
      "id": "11446498",
      "type": "terms_of_service_user_status",
      "tos": {
        "id": "11446498",
        "type": "terms_of_service"
      },
      "user": {
        "id": "11446498",
        "type": "user",
        "name": "Aaron Levie",
        "login": "ceo@example.com"
      },
      "is_accepted": true,
      "created_at": "2012-12-12T10:53:43-08:00",
      "modified_at": "2012-12-12T10:53:43-08:00"
    }
  ]
}

Changes

  • c4d5303fa5c3Revision changes
    • warning

      added the new unprocessable_entity enum value to the response property for the response status