APIActive

Box API

Core Box API covering types and formats for requests, responses, pagination, and error handling.

Open source page

Product features

Product features

box-notifications: off header

Include this header to suppress email and webhook notifications for supported API calls.

Chunked Uploads

Supports uploading large files in chunks.

Developer Tokens

Generate developer tokens for quick testing.

Direction Query Parameter

Use the direction query parameter with values ASC or DESC to set sorting direction.

ETag

ETag value returned in file system item responses.

fields query parameter

Append fields query parameter to request specific fields not returned by default.

File download

Uses API and content delivery domains for authenticated and public downloads.

File preview

Requires access to Box CDN domains for JavaScript and content.

File upload

Uses API and dedicated upload domains.

Full resource variant

Total set of fields when requesting with fields parameter.

HTTP Status Code Ranges

Documentation of HTTP status code ranges (2xx, 3xx, 4xx, 5xx) used by the Box API.

If-Match

Header to ensure consistent changes.

If-None-Match

Header to prevent unnecessary downloads.

Mini resource variant

Reduced set of essential fields for nested resources.

OAuth 2.0 Authentication

Uses OAuth 2.0 for authentication.

Platform Insights

Admins and co-admins can access the Platform Insights dashboard that provides information on the total number of API calls per application.

Request formats

JSON request bodies with exceptions for OAuth and uploads.

Response formats

JSON responses with exceptions for deletions and binary downloads.

RESTful API

The Box API is a RESTful API that follows common HTTP standards where possible.

Sort Query Parameter

Use the sort query parameter to define the field to sort on.

Standard resource variant

Default set of fields returned in an API response.

RFC 3339 timestamps

Supports RFC 3339 timestamps with optional millisecond precision.