> This page is for Developer Documentation.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.benchling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.benchling.com/_mcp/server.

# Getting Started with the V3 Python SDK

The Benchling V3 Python SDK provides typed access to the [Benchling V3 API](/docs/v3-api-overview) from Python.

> **Info**
>
> ### V3 SDK vs. V2 SDK
>
> This is the SDK for Benchling's [V3 API](/docs/v3-api-overview). It is a separate package (`benchling-v3-sdk-python`) from the V2 [`benchling-sdk`](/docs/getting-started-with-the-sdk). Install the one that matches the API version you are calling.

## Installation

```sh
pip install benchling-v3-sdk-python
```

## Authenticate

You can authenticate with either an **API key** or **OAuth client credentials**.

To use an API key, get one from your Benchling account settings:

```python
from benchling_v3_sdk import Benchling

benchling = Benchling(
    base_url="https://yourcompany.benchling.com",
    api_key="<your-api-key>",
    early_access="true",
)
```

To use OAuth client credentials, create an app to generate a client ID and secret:

```python
from benchling_v3_sdk import Benchling

benchling = Benchling(
    base_url="https://yourcompany.benchling.com",
    client_id="<your-client-id>",
    client_secret="<your-client-secret>",
    early_access="true",
)
```

Pass `early_access="true"` to either client to enable beta endpoints.

## Make a request

Now make a request. For example, to list DNA sequences:

```python
for dna_sequence in benchling.dna_sequence.list():
    print(dna_sequence.id, dna_sequence.name)
```

## Next steps

* For code walkthroughs of the interactions you're most likely to need, including pagination, async tasks, error handling, and retries, see [Common SDK Interactions and Examples](/docs/common-sdk-interactions-and-examples-v3).
* For the full set of resources and methods that the SDK exposes, see the API reference.

## Support

For questions or issues, contact [support@benchling.com](mailto:support@benchling.com).