List ToS user statuses

get
https://api.box.com/2.0
/terms_of_service_user_statuses

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

Request

application/json

Query Parameters

stringin queryrequired
324234

The ID of the terms of service.

stringin queryoptional
123334

Limits results to the given user ID.

Response

application/jsonToS User Statuses

Returns a list of terms of service statuses.

You can now try out some of our APIs live, right here in the documentation.
Log In

Request Example

cURL
curl -X GET https://api.box.com/2.0/terms_of_service_user_statuses?tos_id=324234 \
     -H "Authorization: Bearer <ACCESS_TOKEN>"
Node
client.termsOfService.getUserStatus('11111', { user_id: '22222' })
	.then(tosStatus => {
		/* tosStatus -> {
			type: 'terms_of_service_user_status',
			id: '12345',
			tos: { type: 'terms_of_service', id: '11111' },
			user: { type: 'user', id: '22222' },
			is_accepted: true,
			created_at: '2018-04-11T15:33:49-07:00',
			modified_at: '2018-04-11T15:33:49-07:00' }
		*/
	});

Response Example

{
  "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"
    }
  ]
}