# PagerDuty API

**Provider:** PagerDuty
**Category:** developer
**Base URL:** `https://api.pagerduty.com`
**Auth:** bearer — `Authorization: Token token=YOUR_API_KEY`
**Rate Limit:** 960 requests/min
**Free Tier:** No
**Pricing:** Free tier available (freemium)
**Docs:** https://developer.pagerduty.com/api-reference/

## Description

PagerDuty is the leading incident management platform and its REST API exposes all core functionality. Trigger and resolve incidents, manage on-call schedules and overrides, configure escalation policies, list services and integrations, view alert groupings, and pull analytics data for post-mortems. Widely used in DevOps automation, ChatOps bots, and infrastructure monitoring integrations.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://api.pagerduty.com/incidents` | Create a new incident and trigger alerts |
| GET | `https://api.pagerduty.com/incidents` | List incidents with status and date filters |
| PUT | `https://api.pagerduty.com/incidents/{id}` | Acknowledge, resolve, or reassign an incident |
| GET | `https://api.pagerduty.com/schedules` | List on-call schedules |
| GET | `https://api.pagerduty.com/oncalls` | Get currently on-call users |
| GET | `https://api.pagerduty.com/services` | List all services and their integration keys |

## Authentication

Create an API key in PagerDuty Account Settings → API Access. Pass it as a Token in the Authorization header.

```
Authorization: Token token=YOUR_API_KEY
```

## Sample Request

```bash
curl "https://api.pagerduty.com/incidents" \
  -H "Authorization: Token token=$PD_API_KEY" \
  -H "Accept: application/vnd.pagerduty+json;version=2" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"incident":{"type":"incident","title":"DB latency spike","service":{"id":"SVC123","type":"service_reference"}}}'
```

## Sample Response

```json
{
  "incident": {
    "id": "INC123",
    "title": "DB latency spike",
    "status": "triggered",
    "urgency": "high",
    "created_at": "2024-03-15T10:00:00Z",
    "html_url": "https://myorg.pagerduty.com/incidents/INC123"
  }
}
```

## Pricing Details

Starter: free (5 users). Professional: $21/user/mo. Business: $41/user/mo. Digital Operations: $99/user/mo (AIOps).

---

*Source: [API Map](https://apimap.dev/apis/pagerduty/) — CC BY 4.0*