Get aggregated PD Advance usage data

Provides aggregated metrics for the usage of PD Advance.

Note: Data availability reflects pipeline processing cycles and is generally within 24 hours under normal conditions.

Scoped OAuth requires: analytics.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Request Body

application/json

Parameters and filters to apply to the dataset.

TypeScript Definitions

Use the request body type in TypeScript.

filters?

Accepts a set of filters to apply to the Incidents before aggregating. Any incidents that do not match the included filters will be omitted from the results.

time_zone?string

The time zone to use for the results and grouping. Must be in tzdata format. See list of accepted values here.

Response Body

`application/json`

curl -X POST "https://api.pagerduty.com/analytics/metrics/pd_advance_usage/features" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "filters": {      "incident_created_at_start": "2024-01-01T00:00:00-05:00",      "incident_created_at_end": "2024-01-31T00:00:00-05:00",      "urgency": "high",      "major": true    },    "time_zone": "Etc/UTC"  }'

{  "data": [    {      "feature_id": "genai_incident_summarization",      "total_credits_used": 16,      "total_use_count": 8,      "total_proactive_credits_used": 0,      "total_proactive_use_count": 0    },    {      "feature_id": "genai_assist_bot",      "total_credits_used": 1,      "total_use_count": 1,      "total_proactive_credits_used": 0,      "total_proactive_use_count": 0    },    {      "feature_id": "genai_status_updates",      "total_credits_used": 48,      "total_use_count": 16,      "total_proactive_credits_used": 0,      "total_proactive_use_count": 0    },    {      "feature_id": "genai_knowledge_base",      "total_credits_used": 18,      "total_use_count": 9,      "total_proactive_credits_used": 0,      "total_proactive_use_count": 0    },    {      "feature_id": "genai_incident_insight",      "total_credits_used": 96,      "total_use_count": 84,      "total_proactive_credits_used": 0,      "total_proactive_use_count": 36    }  ],  "filters": {    "incident_created_at_end": "2024-10-31T00:00:00Z",    "incident_created_at_start": "2024-10-01T00:00:00Z"  },  "time_zone": "Etc/UTC"}

Get aggregated PD Advance usage data

Authorization

Header Parameters

Request Body

Response Body

200application/json

400application/json

429application/json

`application/json`

`application/json`

`application/json`