---
id: linq-python
version: "0.24.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# linq-python — The official Python library for the linq-api-v3 API

License: permissive · Maintenance: active · Downloads: 162.3K/mo

## What it is and what it does

linq-python is an officially maintained Python SDK for the Linq API V3, a REST API for messaging and chat operations. It wraps the Linq API with type-safe request and response models built on Pydantic, offering both synchronous (LinqAPIV3) and asynchronous (AsyncLinqAPIV3) clients powered by httpx. The library handles pagination automatically, includes built-in retry logic for transient failures, and provides detailed error types for different HTTP status codes.

The SDK is designed for Python 3.9+ applications that need to send messages, create chats, or interact with Linq's messaging infrastructure. It supports nested typed parameters, serialization helpers (to_json, to_dict), and optional aiohttp backend for async workloads. All types are exposed for IDE autocomplete and type checking.

Use it for:

- Build a messaging application that sends SMS or chat messages via the Linq API with full type safety and IDE support.
- Integrate Linq chat functionality into an async web service or background job runner using AsyncLinqAPIV3.
- Fetch and iterate through paginated lists of chats without manually handling pagination logic.
- Handle API errors gracefully by catching specific exception types (RateLimitError, AuthenticationError, etc.).
- Use the optional aiohttp backend for high-concurrency scenarios requiring many simultaneous API calls.

## Worth the install?

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

A Python SDK for the Linq API V3 REST API, providing type-safe synchronous and asynchronous clients with automatic pagination and built-in error handling.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and offers a clean, type-safe interface to the Linq API. It is suitable for production use if you need to integrate Linq messaging into a Python application. The Apache-2.0 license is permissive and the SDK supports current Python versions (3.9+).

## Install

pip install linq-python
uv add linq-python
poetry add linq-python

## Installing linq-python

Before you install: Low friction install with a pure-Python wheel and six standard dependencies. Active maintenance with a recent release and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install linq-python

import os
from linq import LinqAPIV3

client = LinqAPIV3(
    api_key=os.environ.get("LINQ_API_V3_API_KEY"),
)

chat = client.chats.create(
    from_="+12052535597",
    message={},
    to=["+12052532136"],
)
print(chat.chat)

Requires LINQ_API_V3_API_KEY environment variable or explicit api_key parameter to authenticate with the Linq API.

Verify before relying:

- Whether the optional aiohttp backend provides measurable concurrency improvements over the default httpx for typical workloads.
- Rate limit and timeout defaults and whether they suit typical messaging or chat API patterns.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 162.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

linq api python client, rest api sdk python, async http client library, typed api wrapper, messaging api python, pydantic rest client, rest-api-client, async-support, type-safe

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