Join BoxWorks 2024 to discover what's possible with content and AI!

List terms of services

get

https://api.box.com/2.0

/terms_of_services

Returns the current terms of service text and settings for the enterprise.

Request

authorizationbearer [ACCESS_TOKEN]

content-typeapplication/json

Query Parameters

tos_type stringin queryoptional

examplemanaged

Limits the results to the terms of service of the given type.

Value is one of external,managed

Response

200application/jsonTerms of services

Returns a collection of terms of service text and settings for the enterprise.

defaultapplication/jsonClient error

An unexpected client error.

get

List terms of services

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

Request Example

cURL

curl -i -X GET "https://api.box.com/2.0/terms_of_services" \
     -H "authorization: Bearer <ACCESS_TOKEN>"

TypeScript Gen

await client.termsOfServices.getTermsOfService();

Python Gen

client.terms_of_services.get_terms_of_service()

.NET Gen

await client.TermsOfServices.GetTermsOfServiceAsync();

Swift Gen (Beta)

try await client.termsOfServices.getTermsOfService()

Java

List<BoxTermsOfService.Info> termsOfServices = BoxTermsOfService.getAllTermsOfServices(api);
for(BoxTermsOfService.Info termsOfServiceInfo : termsOfServices){
    // Do something with the terms of service.
}

Python

terms_of_services = client.get_terms_of_services()
for terms_of_service in terms_of_services:
    print(f'Terms of Service ID is {terms_of_service.id} and the message is {terms_of_service.text}')

.NET

BoxTermsOfServiceCollection<BoxTermsOfService> termsOfService = await client.TermsOfServiceManager
    .GetTermsOfServicesAsync();

Node

client.termsOfService.getAll()
	.then(termsOfService => {
		/* termsOfService -> {
			entries: [
				total_count: 1,
				{ type: 'terms_of_service',
				id: '12345',
				status: 'disabled',
				enterprise: { type: 'enterprise', id: '55555' },
				tos_type: 'managed',
				text: 'By using this service, you agree to ...',
				created_at: '2018-04-19T13:55:09-07:00',
				modified_at: '2018-04-19T13:55:09-07:00' }
			]
		*/
	});

iOS

let termsOfServiceItems = client.termsOfService.listForEnterprise()

print("Terms of Service with ID \(termsOfServiceItems[0].id) and Terms of Service with ID \(termsOfServiceItems[1].id) was retrieved.")

Response Example

{
  "entries": [
    {
      "id": "11446498",
      "type": "terms_of_service",
      "status": "enabled",
      "enterprise": {
        "id": "11446498",
        "type": "enterprise",
        "name": "Acme Inc."
      },
      "tos_type": "managed",
      "text": "By using this service, you agree to ...",
      "created_at": "2012-12-12T10:53:43-08:00",
      "modified_at": "2012-12-12T10:53:43-08:00"
    }
  ],
  "total_count": 2
}