---
id: openresponses-types
version: "2.4.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# openresponses-types — Python SDK for OpenResponses specification

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

## What it is and what it does

OpenResponses Types is a Python SDK that wraps the OpenResponses API specification as Pydantic models. It provides type-safe data structures for interacting with OpenResponses services, generated directly from the OpenAPI specification. The package is maintained by Mozilla AI and tracks the upstream spec version via a `__spec_hash__` attribute, allowing you to know which API version your models correspond to.

The package depends only on pydantic and is distributed as a pure Python wheel, making installation straightforward. It follows semantic versioning: major bumps for breaking changes to the helper types, minor bumps for new types from spec updates, and patch bumps for bug fixes. The repository is actively maintained with recent releases, and the package supports modern Python versions (3.11–3.13).

Use it for:

- Building a Python client library that consumes the OpenResponses API with full type checking and IDE autocomplete.
- Validating incoming or outgoing data structures against the OpenResponses specification in your application.
- Generating API request/response payloads with confidence that they match the current spec version.
- Integrating OpenResponses into a larger LLM orchestration or AI workflow tool with type safety.

## Worth the install?

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

Provides Pydantic models for the OpenResponses API specification, enabling type-safe interaction with OpenResponses services in Python.

Yes, if you are building a Python application that interacts with OpenResponses. The package is actively maintained, has no known vulnerabilities, installs with minimal friction, and provides the type safety and IDE support that Pydantic models offer. The Apache 2.0 license is permissive. If you are not using OpenResponses, this package is not relevant.

## Install

pip install openresponses-types
uv add openresponses-types
poetry add openresponses-types

## Installing openresponses-types

Before you install: Low friction: pure Python wheel with a single runtime dependency on pydantic. Active maintenance with a release 9 days ago; repository is not archived and supports current Python versions (3.11–3.13).

License in practice: Apache 2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Quickstart:

pip install openresponses-types

from openresponses_types import <model_name>

# Use Pydantic model for type validation
response = <model_name>(**data)

Requires Python 3.11 or later.

Verify before relying:

- Which specific Pydantic models are included and what OpenResponses API endpoints they cover.
- Whether the package includes helper utilities beyond raw Pydantic model definitions.
- How frequently the OpenAPI spec is updated and how that triggers version bumps.

## Package facts

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

## Tags

pydantic models openapi, openresponses api types, llm api client types, type-safe api specification, openapi schema pydantic, api specification models, pydantic-models, openapi-types, llm-sdk

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