Manage Applications

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