---
id: boxsdk
version: "10.14.0"
license: Apache-2.0, http://www.apache.org/licenses/LICENSE-2.0
license_treatment: permissive
maintenance: active
---

# boxsdk — Official Box Python SDK

License: permissive · Maintenance: active · Downloads: 4.7M/mo

## What it is and what it does

The Box Python SDK v10 is a client library for the Box Content Cloud API, built on an auto-generated codebase. It replaces the older manual boxsdk v3 and provides complete API coverage with embedded documentation, automatic retries with exponential backoff, and exception handling. The SDK supports multiple authentication methods including Developer Token, OAuth 2.0, Client Credentials Grant, and JWT.

Developers use it to programmatically interact with Box accounts—listing folders, uploading and downloading files, managing permissions, and accessing other Box features. The library handles HTTP communication through requests and requests-toolbelt, manages authentication state, and abstracts Box's REST API into Python objects and manager classes. It is intended for new applications and for users migrating from earlier SDK versions.

Use it for:

- Automate file uploads, downloads, and organization in Box from Python applications.
- Build integrations that list, search, and manage Box folders and files programmatically.
- Implement Box authentication in web or desktop applications using OAuth 2.0 or JWT.
- Create batch operations on Box content without manual API calls.
- Embed Box content management into data pipelines or ETL workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Python client library for interacting with Box's cloud content management API, supporting authentication, file operations, and folder management.

Yes. The SDK is actively maintained, has low install friction, carries no known vulnerabilities, and is the recommended choice for new Box integrations. Use v10 if starting fresh; existing v3 users should evaluate migration to v10 or v4 depending on their codebase state.

## Install

pip install boxsdk
uv add boxsdk
poetry add boxsdk

## Installing boxsdk

Before you install: Low install friction with only 2 runtime dependencies (requests and requests-toolbelt). Actively maintained with a release 9 days old and recent commits; marked as Production/Stable.

License in practice: Apache-2.0 license is permissive, allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.

Quickstart:

pip install boxsdk>=10

from boxsdk import BoxClient, BoxDeveloperTokenAuth

auth = BoxDeveloperTokenAuth(token='YOUR_TOKEN')
client = BoxClient(auth=auth)
for item in client.folders.get_folder_items('0').entries:
    print(item.name)

Requires a Box Developer Token or other supported authentication credentials (OAuth 2.0, Client Credentials, or JWT); JWT auth requires optional jwt extra dependencies.

Verify before relying:

- Whether all Box API endpoints are fully covered or if some legacy endpoints remain unavailable in v10.
- Performance characteristics and rate-limiting behavior when handling large file operations or bulk requests.
- Compatibility guarantees for PyPy implementation beyond CPython versions listed.

## Package facts

- License: Apache-2.0, http://www.apache.org/licenses/LICENSE-2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 4.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

box api python client, box cloud storage sdk, box content management api, box file operations library, box authentication python, box rest api wrapper, box folder management, box-api, rest-client, cloud-storage

[View on SkillFed](https://skillfed.io/packages/boxsdk) · [View on PyPI](https://pypi.org/project/boxsdk/)