PagerDuty Licenses API
Licenses are allocated to Users to allow for per-User access to PagerDuty functionality within an Account.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/pagerduty-licenses-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: 'This document describes the PagerDuty REST APIs.
For guides and examples please visit our Documentation.
Our REST APIs are defined in OpenAPI v3.x. You can view the schema at github.com/PagerDuty/api-schema.
Note that properties in some schemas have fields not shown by default such as `readOnly`, `format`, and `default`. Hover your cursor over the right column that looks like `optional+1` to see the full list of fields.'
contact:
name: PagerDuty Support
url: http://www.pagerduty.com/support
email: support@pagerduty.com
title: PagerDuty Licenses API
version: 2.0.0
servers:
- url: https://api.pagerduty.com
description: PagerDuty V2 API.
security:
- api_key: []
tags:
- name: Licenses
description: Licenses are allocated to Users to allow for per-User access to PagerDuty functionality within an Account.
paths:
/license_allocations:
description: The Licenses allocated to Users within your Account
get:
x-pd-requires-scope: licenses.read
tags:
- Licenses
operationId: listLicenseAllocations
description: 'List the Licenses allocated to Users within your Account
Scoped OAuth requires: `licenses.read`'
summary: PagerDuty List License Allocations
parameters:
- $ref: '#/components/parameters/header_Accept'
- $ref: '#/components/parameters/header_Content-Type'
- $ref: '#/components/parameters/offset_limit'
- $ref: '#/components/parameters/offset_offset'
responses:
'200':
description: License allocations to Users within your Account
content:
application/json:
schema:
allOf:
- type: object
properties:
license_allocations:
type: array
items:
type: object
required:
- user
- license
- allocated_at
properties:
user:
$ref: '#/components/schemas/UserReference'
license:
$ref: '#/components/schemas/LicenseWithCounts/allOf/0'
allocated_at:
type: string
description: Indicates the date and time the License was allocated to the User
format: date-time
- $ref: '#/components/schemas/Pagination'
examples:
response:
summary: Response Example
value:
license_allocations:
- license:
id: PIP248G
name: Business (Full User)
description: Event Intelligence
valid_roles:
- owner
- admin
- user
- limited_user
- observer
- restricted_access
role_group: FullUser
summary: Business (Full User)
type: license
self: null
html_url: null
user:
id: PIP248H
type: user_reference
allocated_at: '2021-06-01T00:00:00-05:00'
offset: 0
limit: 1
more: false
total: 2
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
/licenses:
description: The Licenses associated with your Account
get:
x-pd-requires-scope: licenses.read
tags:
- Licenses
operationId: listLicenses
description: 'List the Licenses associated with your Account
Scoped OAuth requires: `licenses.read`'
summary: PagerDuty List Licenses
parameters:
- $ref: '#/components/parameters/header_Accept'
- $ref: '#/components/parameters/header_Content-Type'
responses:
'200':
description: Licenses associated with your Account
content:
application/json:
schema:
type: object
properties:
licenses:
type: array
items:
$ref: '#/components/schemas/LicenseWithCounts'
examples:
response:
summary: Example Response
value:
licenses:
- id: PIP248G
name: Business (Full User)
description: Event Intelligence
current_value: 234
allocations_available: 4766
valid_roles:
- owner
- admin
- user
- limited_user
- observer
- restricted_access
role_group: FullUser
summary: Business (Full User)
type: license
self: null
html_url: null
- id: PTHH1SQ
name: Business (Full User)
description: ''
current_value: 0
allocations_available: 4766
valid_roles:
- owner
- admin
- user
- limited_user
- observer
- restricted_access
role_group: FullUser
summary: Business (Full User)
type: license
self: null
html_url: null
- id: PQ8W0D0
name: Business (Stakeholder)
description: ''
current_value: 48
allocations_available: 4952
valid_roles:
- read_only_user
- read_only_limited_user
role_group: Stakeholder
summary: Business (Stakeholder)
type: license
self: null
html_url: null
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
components:
responses:
Unauthorized:
description: 'Caller did not supply credentials or did not provide the correct credentials.
If you are using an API key, it may be invalid or your Authorization header may be malformed.
'
content:
application/json:
schema:
$ref: '#/components/responses/Conflict/content/application~1json/schema'
Conflict:
description: The request conflicts with the current state of the server.
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: integer
readOnly: true
message:
type: string
readOnly: true
description: Error message string
errors:
type: array
readOnly: true
items:
type: string
readOnly: true
description: Human-readable error details
example:
message: Not Found
code: 2100
Forbidden:
description: 'Caller is not authorized to view the requested resource.
While your authentication is valid, the authenticated user or token does not have permission to perform this action.
'
content:
application/json:
schema:
$ref: '#/components/responses/Conflict/content/application~1json/schema'
NotFound:
description: The requested resource was not found.
content:
application/json:
schema:
$ref: '#/components/responses/Conflict/content/application~1json/schema'
parameters:
header_Content-Type:
name: Content-Type
in: header
required: true
schema:
type: string
default: application/json
enum:
- application/json
header_Accept:
name: Accept
description: The `Accept` header is used as a versioning header.
in: header
required: true
schema:
type: string
default: application/vnd.pagerduty+json;version=2
offset_limit:
name: limit
in: query
required: false
description: The number of results per page.
schema:
type: integer
offset_offset:
name: offset
in: query
required: false
description: Offset to start pagination search results.
schema:
type: integer
schemas:
LicenseWithCounts:
allOf:
- type: object
required:
- id
- description
- name
- valid_roles
properties:
id:
type: string
description: Uniquely identifies the resource
description:
type: string
description: 'Description of the License. May include the names of add-ons associated with
the License, if there are any.
'
name:
type: string
description: 'Name of the License.
'
valid_roles:
type: array
description: The roles a User with this License can have
items:
type: string
role_group:
type: string
enum:
- FullUser
- Stakeholder
description: Indicates whether this License is assignable to full or stakeholder Users
example: FullUser
type:
type: string
description: Type of object
self:
type: string
description: API URL to access the License
html_url:
type: string
description: HTML URL to access the License
summary:
type: string
description: Summary of the License
- type: object
properties:
current_value:
type: integer
description: How many of these Licenses are currently allocated to Users
allocations_available:
type:
- integer
- 'null'
description: 'How many of these licenses are available to be allocated to a user. If this
value is "null" then there is no limit on the number of allocations allowed.
'
UserReference:
allOf:
- $ref: '#/components/schemas/Reference'
- type: object
properties:
type:
type: string
enum:
- user_reference
Pagination:
type: object
properties:
offset:
type: integer
description: Echoes offset pagination property.
readOnly: true
limit:
type: integer
description: Echoes limit pagination property.
readOnly: true
more:
type: boolean
description: Indicates if there are additional records to return
readOnly: true
total:
type:
- integer
- 'null'
description: The total number of records matching the given query.
readOnly: true
Reference:
allOf:
- $ref: '#/components/schemas/Tag/allOf/0'
- type: object
required:
- type
- id
Tag:
allOf:
- type: object
properties:
id:
type: string
readOnly: true
summary:
type:
- string
- 'null'
readOnly: true
description: A short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to `name`, though it is not intended to be an identifier.
type:
type: string
readOnly: true
description: A string that determines the schema of the object. This must be the standard name for the entity, suffixed by `_reference` if the object is a reference.
self:
type:
- string
- 'null'
readOnly: true
format: url
description: the API show URL at which the object is accessible
html_url:
type:
- string
- 'null'
readOnly: true
format: url
description: a URL at which the entity is uniquely displayed in the Web app
- type: object
properties:
type:
type: string
description: The type of object being created.
default: tag
enum:
- tag
label:
type: string
description: The label of the tag.
maxLength: 191
required:
- label
- type
example:
type: tag
label: Batman
securitySchemes:
api_key:
type: apiKey
name: Authorization
in: header
description: The API Key with format `Token token=<API_KEY>`