---
id: pagerduty
version: "7.0.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# pagerduty — Clients for PagerDuty's Public APIs

License: unclear · Maintenance: active · Downloads: 5.7M/mo

## What it is and what it does

This is a Python client library for interacting with PagerDuty's public REST APIs. It wraps httpx2 to provide a higher-level abstraction that handles authentication, pagination, filtering, and automatic connection pooling, eliminating boilerplate code when making requests to PagerDuty. The library is designed to balance ease of use with direct access to the underlying HTTP client, so you can still inspect response headers or set custom request headers when needed.

The package includes both a programmatic API for use in Python applications and a command-line interface for triggering incidents and other Events API operations. It was built to replace code duplication in PagerDuty's own internal tooling and is the successor to the pdpyras library. It handles rate limiting with configurable cooldown and reattempt logic, and supports Python 3.10 through 3.13.

Use it for:

- Trigger incidents or send events to PagerDuty from Python applications or monitoring systems
- Query incidents, users, schedules, or other PagerDuty objects with built-in pagination and filtering
- Build automation scripts that interact with PagerDuty's REST API without managing HTTP details
- Integrate PagerDuty alerting into custom Python-based incident response workflows
- Use the CLI tool to trigger incidents directly from shell scripts or cron jobs

## Worth the install?

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

Lightweight Python client library for PagerDuty's REST API v2 and Events API v2, with built-in support for authentication, pagination, rate limiting, and connection pooling.

Yes. The package is actively maintained, has low install friction, no known vulnerabilities, and is widely used (top 5000 on PyPI). It directly solves the problem of interacting with PagerDuty's APIs from Python. The only caveat is to verify the license treatment before use, since metadata indicates it is unclear despite the description stating MIT.

## Install

pip install pagerduty
uv add pagerduty
poetry add pagerduty

## Installing pagerduty

Before you install: Low friction install with a single runtime dependency (httpx2). Actively maintained with a release within the last 30 days and support for modern Python versions (3.10+).

License in practice: License treatment is unclear in the metadata, though the description excerpt states the code is made available under the MIT License. Verify the actual license file in the repository before relying on this for compliance.

Quickstart:

pip install pagerduty

from pagerduty import EventsAPIV2Client

client = EventsAPIV2Client(routing_key='your-routing-key')
client.trigger(description='Network latency is high')

Requires Python 3.10 or later; a valid PagerDuty routing key or API token is needed for authentication.

Verify before relying:

- Whether license_spdx and license_raw being null reflects a packaging issue or genuine metadata gap in the repository
- Full scope of API endpoints and resources covered by the client abstraction layer
- Whether the CLI tool (pagerduty trigger, etc.) is feature-complete or limited to Events API v2

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 5.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pagerduty api client, pagerduty python library, incident management api, pagerduty rest client, pagerduty events api, on-call scheduling api, alert routing python, incident-management, api-client, monitoring

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