---
id: types-aiobotocore-cloudtrail
version: "3.9.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# types-aiobotocore-cloudtrail — Type annotations for aiobotocore CloudTrail 3.9.0 service generated with mypy-boto3-builder 8.12.0

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

## What it is and what it does

This package is a type stub library that adds static type information for aiobotocore's CloudTrail service. It is generated automatically using mypy-boto3-builder and works with type checkers (mypy, pyright) and IDEs (VSCode, PyCharm, Emacs, Sublime Text) to provide code completion and catch type errors before runtime.

The package contains type annotations for CloudTrailClient, paginators, and service-specific type definitions. It is designed to be installed alongside aiobotocore and requires only typing-extensions as a runtime dependency. The annotations enable developers to write async CloudTrail code with full IDE support and static type safety, without requiring explicit type annotations in most cases.

Use it for:

- Enable IDE autocomplete and type checking when writing async CloudTrail audit log queries with aiobotocore.
- Catch type mismatches in CloudTrail API calls during development using mypy or pyright before deployment.
- Provide explicit type hints for CloudTrailClient, paginators, and response objects in production async code.
- Support team development by making CloudTrail API contracts visible in VSCode, PyCharm, and other editors.
- Use with TYPE_CHECKING guards to add type safety without adding a production runtime dependency.

## Worth the install?

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

Provides type annotations for aiobotocore's CloudTrail service, enabling type checking and IDE code completion for async AWS CloudTrail operations.

Yes. If you use aiobotocore for CloudTrail operations, this package is worth installing. It has low install friction, active maintenance, MIT licensing, no known vulnerabilities, and provides immediate value through IDE support and type checking. The only caveat is PyCharm users may experience performance issues with Literal overloads; the documentation suggests using the lite variant in that case.

## Install

pip install types-aiobotocore-cloudtrail
uv add types-aiobotocore-cloudtrail
poetry add types-aiobotocore-cloudtrail

## Installing types-aiobotocore-cloudtrail

Before you install: Low install friction with a single lightweight runtime dependency (typing-extensions). Actively maintained with recent releases; last commit 2026-06-22 and release 12 days old.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects.

Quickstart:

pip install types-aiobotocore-cloudtrail

from aiobotocore.session import get_session
from types_aiobotocore_cloudtrail import CloudTrailClient

session = get_session()
async with session.create_client("cloudtrail") as client:
    client: CloudTrailClient  # type checking now enabled

Requires aiobotocore 3.9.0 to be installed separately; Python 3.9 or later.

Verify before relying:

- Whether PyCharm performance issues with Literal overloads mentioned in the description have been resolved in current versions.
- Actual type coverage completeness for all CloudTrail operations and edge cases.

## Package facts

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

## Tags

aiobotocore cloudtrail type stubs, aws cloudtrail async type hints, mypy boto3 cloudtrail annotations, pyright aiobotocore cloudtrail, cloudtrail client type checking, aiobotocore type stubs generator, ide autocomplete aws cloudtrail, type-stubs, aws-sdk, async

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