---
id: mypy-boto3-xray
version: "1.43.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# mypy-boto3-xray — Type annotations for boto3 XRay 1.43.0 service generated with mypy-boto3-builder 8.12.0

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

## What it is and what it does

mypy-boto3-xray is a stub package that adds type annotations for the boto3 XRay service. It is generated from boto3 1.43.0 using mypy-boto3-builder 8.12.0 and works with type checkers (mypy, pyright) and IDEs (VSCode, PyCharm, Emacs, Sublime Text) to provide type checking and code completion for XRay API calls.

The package is designed as a development-time dependency—you install it in your environment to get IDE support and type checking, but it does not affect runtime behavior. It provides explicit type annotations for the XRayClient, paginators, and type definitions, allowing you to catch API misuse before runtime. The package supports Python 3.9 through 3.14 and has no production dependencies beyond typing-extensions.

Use it for:

- Enable IDE autocompletion and type hints when writing boto3 XRay API calls in VSCode or PyCharm.
- Catch XRay API usage errors during static type checking with mypy or pyright before deployment.
- Provide explicit type annotations for XRayClient, paginators, and service resources in larger codebases.
- Support distributed tracing workflows by ensuring correct parameter types and return values for XRay operations.

## Worth the install?

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

Provides type annotations for boto3's XRay service, enabling type checking and IDE autocompletion for XRay API calls in mypy, pyright, VSCode, PyCharm, and other tools.

Yes, if you use boto3's XRay service and want type safety and IDE support. Install friction is minimal, maintenance is active, and there are no security issues. The MIT license poses no restrictions. Consider boto3-stubs-lite as an alternative if PyCharm performance is a concern.

## Install

pip install mypy-boto3-xray
uv add mypy-boto3-xray
poetry add mypy-boto3-xray

## Installing mypy-boto3-xray

Before you install: Low install friction with a single lightweight runtime dependency (typing-extensions). Actively maintained with recent releases and no known vulnerabilities.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and proprietary projects.

Quickstart:

pip install mypy-boto3-xray

from boto3.session import Session
from mypy_boto3_xray import XRayClient

client: XRayClient = Session().client("xray")
# Type checking and IDE completion now work on client calls

Requires Python 3.9 or later; boto3 must be installed separately to use the annotations at runtime.

Verify before relying:

- Whether PyCharm performance issues with Literal overloads (mentioned in docs) still affect current versions.
- Whether the lite variant (boto3-stubs-lite) offers meaningful performance benefits for typical XRay workloads.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

boto3 xray type annotations, mypy boto3 stubs, xray type hints, boto3 type checking, aws xray typing, boto3 ide autocomplete, xray client type hints, type-stubs, aws-sdk, boto3

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