Jira

APIs for Atlassian Jira project management and issue tracking platform.

Jira publishes 8 APIs on the APIs.io network, including Issue Comments API, Issue Priorities API, Issue Search API, and 5 more. Tagged areas include Agile, Issue Tracking, ITSM, Project Management, and Service Management.

The Jira catalog on APIs.io includes 1 event-driven AsyncAPI specification, 2 JSON-LD contexts, and 3 Spectral governance rulesets.

Jira’s developer surface includes changelog, CLI, authentication, developer portal, getting-started guide, support, engineering blog, and 40 more developer resources.

🌐 Visit website 📡 Source on GitHub

72.5/100 exemplar ▬ flat Agent 67/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

12 APIs 1 MCP Servers 16 Features 5 Use Cases

AgileIssue TrackingITSMProject ManagementService Management

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 72.5/100 · exemplar

Contract Quality 20.4 / 25

Developer Ergonomics 12.6 / 20

Commercial Clarity 13.7 / 20

Operational Transparency 9.6 / 13

Governance 7.1 / 12

Discoverability 9.1 / 10

Agent readiness — 67/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 0 / 5

Well-Known Catalog 4 / 4

Consent & Bot Identity 3 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/jira: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 12

Individual APIs this provider publishes, each with its own machine-readable definition.

Jira Cloud Platform REST API v2

Version 2 of the Jira Cloud platform REST API, offering the same operations as v3 but without Atlassian Document Format support.

Jira Service Management Operations REST API

Operations APIs for Jira Service Management covering schedules, on-call rotations, alerts, escalations, and incident management.

Jira Align REST API

REST API for Jira Align enterprise agile planning platform, providing access to portfolios, epics, features, and program management data.

Jira Customer Service Management REST API

REST API for Atlassian Customer Service Management providing access to customers, organizations, products, and entitlements data.

Jira Issue Comments API

Manage comments on issues.

Jira Issue Priorities API

Retrieve issue priority levels.

Jira Issue Search API

Search for issues using JQL (Jira Query Language).

Jira Issue Statuses API

Retrieve issue statuses.

Jira Issue Transitions API

Retrieve and perform workflow transitions on issues.

Jira Issue Types API

Retrieve and manage issue types for projects.

Jira Issues API

Create, read, update, delete, and transition Jira issues.

Jira Projects API

Manage Jira projects including metadata, roles, and components.

Scroll for all 12

Postman Collections 8

Ready-to-run Postman collections for exercising this provider's APIs.

Jira Cloud Platform REST Issue Comments API

POSTMAN

Jira Cloud Platform REST Issue Comments Issue Priorities API

POSTMAN

Jira Cloud Platform REST Issue Comments Issue Search API

POSTMAN

Jira Cloud Platform REST Issue Comments Issue Statuses API

POSTMAN

Jira Cloud Platform REST Issue Comments Issue Transitions API

POSTMAN

Jira Cloud Platform REST Issue Comments Issue Types API

POSTMAN

Jira Cloud Platform REST Issue Comments Issues API

POSTMAN

Jira Cloud Platform REST Issue Comments Projects API

POSTMAN

Scroll for all 8

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Jira Cloud Platform REST API

OPEN COLLECTION

Arazzo Workflows 10

Multi-step API workflows described with the Arazzo specification.

Jira Read an Issue Comment Thread and Reply

Read an issue, page through its comment thread oldest-first, then add a reply.

ARAZZO

Jira Create an Issue and Read It Back

Resolve project metadata, create an issue, then read back the stored issue.

ARAZZO

Jira Deduplicate Issue Intake

Search for an existing issue by JQL and either comment on the duplicate or create a new issue.

ARAZZO

Jira Edit an Issue and Verify the Change

Read an issue, apply a field edit and label operations, then re-read to verify.

ARAZZO

Jira Bootstrap Issue Creation Metadata

Cache the projects, issue types, and priorities an issue-creation surface needs.

ARAZZO

Jira Run a JQL Report and Drill Into a Result

Run a JQL search via GET, then drill into the first matching issue and its comments.

ARAZZO

Jira Discover a Project and Its Workflow Statuses

Search projects by name, read the matched project, and map its per-issue-type statuses.

ARAZZO

Jira Safely Delete an Issue

Read an issue and its sub-tasks first, then delete it with an explicit sub-task decision.

ARAZZO

Jira Sweep a Stale Issue Through a Transition

Find stale issues with JQL, annotate the first match, discover its transitions, and close it.

ARAZZO

Jira Transition an Issue to a New Status

Read an issue, discover its legal transitions, apply one, and verify the new status.

ARAZZO

Scroll for all 10

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Atlassian Rovo MCP Server

MCP SERVER

GraphQL 1

GraphQL schemas published by this provider.

Jira GraphQL API

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Jira Plans Pricing

4 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Jira Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Jira Finops

FINOPS

Features 16

Notable capabilities this provider offers.

Free: up to 10 users

Standard: $7.91-$9.05/user/mo (volume tiered)

Premium: $14.54-$18.30/user/mo with Advanced Roadmaps

Enterprise custom: Atlassian Intelligence, 99.95% uptime, data residency

Volume discount: rates drop above 100 users (max 50K)

REST API v3 at api.atlassian.com

GraphQL API for some products

Token-bucket rate limit ~10 req/sec/app/user

Bulk operations max 100 items/request

Webhooks v3 for issue/project events

OAuth 2.0 (3LO) and API tokens

Atlassian Connect framework for marketplace apps

Forge for serverless app development

JQL (Jira Query Language) for advanced search

Atlassian Intelligence AI assistant (Enterprise)

Cross-product Analytics + Atlas integrations

Scroll for all 16

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Jira Cloud Webhooks

Jira Cloud webhooks deliver HTTP POST payloads to a configured URL whenever specified events occur in your Jira instance. Webhooks can be registered via the Jira REST API or thr...

ASYNCAPI

Semantic Vocabularies 2

JSON-LD contexts and semantic vocabularies used across these APIs.

Jira Cloud Platform Rest Context

0 classes · 0 properties

JSON-LD

Jira Context

0 classes · 15 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs.

Jira API Rules

6 rules · 1 errors 4 warnings 1 info

SPECTRAL

Jira API Rules

6 rules · 4 warnings 2 info

SPECTRAL

Jira API Rules

17 rules · 8 errors 7 warnings 2 info

SPECTRAL

JSON Schema 46

Standalone JSON Schema definitions for this provider's data models.

AtlassianDocumentFormat

3 properties

JSON SCHEMA

Attachment

8 properties

JSON SCHEMA

AvatarUrls

4 properties

JSON SCHEMA

ChangeHistory

3 properties

JSON SCHEMA

ChangeItem

7 properties

JSON SCHEMA

Changelog

4 properties

JSON SCHEMA

Comment

6 properties

JSON SCHEMA

Component

7 properties

JSON SCHEMA

CreatedIssue

4 properties

JSON SCHEMA

EntityProperty

2 properties

JSON SCHEMA

ErrorCollection

3 properties

JSON SCHEMA

FieldUpdateOperation

5 properties

JSON SCHEMA

IssueBean

8 properties

JSON SCHEMA

IssueCreateRequest

4 properties

JSON SCHEMA

IssueFields

17 properties

JSON SCHEMA

IssueLink

2 properties

JSON SCHEMA

IssueLinkType

5 properties

JSON SCHEMA

IssueRef

4 properties

JSON SCHEMA

IssueTransitionRequest

3 properties

JSON SCHEMA

IssueTypeDetails

8 properties

JSON SCHEMA

IssueTypeWithStatus

5 properties

JSON SCHEMA

IssueUpdateRequest

4 properties

JSON SCHEMA

PageBeanProject

7 properties

JSON SCHEMA

PageOfComments

4 properties

JSON SCHEMA

PageOfWorklogs

4 properties

JSON SCHEMA

Priority

6 properties

JSON SCHEMA

ProjectCategory

4 properties

JSON SCHEMA

ProjectRef

5 properties

JSON SCHEMA

Project

17 properties

JSON SCHEMA

Resolution

4 properties

JSON SCHEMA

Scope

1 properties

JSON SCHEMA

SearchRequest

8 properties

JSON SCHEMA

SearchResults

8 properties

JSON SCHEMA

StatusCategory

5 properties

JSON SCHEMA

StatusDetails

5 properties

JSON SCHEMA

TransitionRef

1 properties

JSON SCHEMA

Transition

7 properties

JSON SCHEMA

Transitions

2 properties

JSON SCHEMA

UserDetails

7 properties

JSON SCHEMA

Version

10 properties

JSON SCHEMA

Visibility

3 properties

JSON SCHEMA

Votes

3 properties

JSON SCHEMA

Watches

3 properties

JSON SCHEMA

Worklog

7 properties

JSON SCHEMA

Jira Issue

10 properties

JSON SCHEMA

Jira Project

22 properties

JSON SCHEMA

Scroll for all 46

JSON Structure 44

JSON Structure definitions describing this provider's data shapes.

Jira Cloud Platform Rest Atlassian Document Format Structure

3 properties

JSON STRUCTURE

Jira Cloud Platform Rest Attachment Structure

8 properties

JSON STRUCTURE

Jira Cloud Platform Rest Avatar Urls Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Change History Structure

3 properties

JSON STRUCTURE

Jira Cloud Platform Rest Change Item Structure

7 properties

JSON STRUCTURE

Jira Cloud Platform Rest Changelog Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Comment Structure

6 properties

JSON STRUCTURE

Jira Cloud Platform Rest Component Structure

7 properties

JSON STRUCTURE

Jira Cloud Platform Rest Created Issue Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Entity Property Structure

2 properties

JSON STRUCTURE

Jira Cloud Platform Rest Error Collection Structure

3 properties

JSON STRUCTURE

Jira Cloud Platform Rest Field Update Operation Structure

5 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Bean Structure

8 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Create Request Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Fields Structure

17 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Link Structure

2 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Link Type Structure

5 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Ref Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Transition Request Structure

3 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Type Details Structure

8 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Type With Status Structure

5 properties

JSON STRUCTURE

Jira Cloud Platform Rest Issue Update Request Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Page Bean Project Structure

7 properties

JSON STRUCTURE

Jira Cloud Platform Rest Page Of Comments Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Page Of Worklogs Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Priority Structure

6 properties

JSON STRUCTURE

Jira Cloud Platform Rest Project Category Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Project Ref Structure

5 properties

JSON STRUCTURE

Jira Cloud Platform Rest Project Structure

17 properties

JSON STRUCTURE

Jira Cloud Platform Rest Resolution Structure

4 properties

JSON STRUCTURE

Jira Cloud Platform Rest Scope Structure

1 properties

JSON STRUCTURE

Jira Cloud Platform Rest Search Request Structure

8 properties

JSON STRUCTURE

Jira Cloud Platform Rest Search Results Structure

8 properties

JSON STRUCTURE

Jira Cloud Platform Rest Status Category Structure

5 properties

JSON STRUCTURE

Jira Cloud Platform Rest Status Details Structure

5 properties

JSON STRUCTURE

Jira Cloud Platform Rest Transition Ref Structure

1 properties

JSON STRUCTURE

Jira Cloud Platform Rest Transition Structure

7 properties

JSON STRUCTURE

Jira Cloud Platform Rest Transitions Structure

2 properties

JSON STRUCTURE

Jira Cloud Platform Rest User Details Structure

7 properties

JSON STRUCTURE

Jira Cloud Platform Rest Version Structure

10 properties

JSON STRUCTURE

Jira Cloud Platform Rest Visibility Structure

3 properties

JSON STRUCTURE

Jira Cloud Platform Rest Votes Structure

3 properties

JSON STRUCTURE

Jira Cloud Platform Rest Watches Structure

3 properties

JSON STRUCTURE

Jira Cloud Platform Rest Worklog Structure

7 properties

JSON STRUCTURE

Scroll for all 44

Examples 44

Example request and response payloads for these APIs.

Jira Cloud Platform Rest Atlassian Document Format Example

3 fields

EXAMPLE

Jira Cloud Platform Rest Attachment Example

8 fields

EXAMPLE

Jira Cloud Platform Rest Avatar Urls Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Change History Example

3 fields

EXAMPLE

Jira Cloud Platform Rest Change Item Example

7 fields

EXAMPLE

Jira Cloud Platform Rest Changelog Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Comment Example

6 fields

EXAMPLE

Jira Cloud Platform Rest Component Example

7 fields

EXAMPLE

Jira Cloud Platform Rest Created Issue Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Entity Property Example

2 fields

EXAMPLE

Jira Cloud Platform Rest Error Collection Example

3 fields

EXAMPLE

Jira Cloud Platform Rest Field Update Operation Example

5 fields

EXAMPLE

Jira Cloud Platform Rest Issue Bean Example

8 fields

EXAMPLE

Jira Cloud Platform Rest Issue Create Request Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Issue Fields Example

17 fields

EXAMPLE

Jira Cloud Platform Rest Issue Link Example

2 fields

EXAMPLE

Jira Cloud Platform Rest Issue Link Type Example

5 fields

EXAMPLE

Jira Cloud Platform Rest Issue Ref Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Issue Transition Request Example

3 fields

EXAMPLE

Jira Cloud Platform Rest Issue Type Details Example

8 fields

EXAMPLE

Jira Cloud Platform Rest Issue Type With Status Example

5 fields

EXAMPLE

Jira Cloud Platform Rest Issue Update Request Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Page Bean Project Example

7 fields

EXAMPLE

Jira Cloud Platform Rest Page Of Comments Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Page Of Worklogs Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Priority Example

6 fields

EXAMPLE

Jira Cloud Platform Rest Project Category Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Project Example

17 fields

EXAMPLE

Jira Cloud Platform Rest Project Ref Example

5 fields

EXAMPLE

Jira Cloud Platform Rest Resolution Example

4 fields

EXAMPLE

Jira Cloud Platform Rest Scope Example

1 fields

EXAMPLE

Jira Cloud Platform Rest Search Request Example

8 fields

EXAMPLE

Jira Cloud Platform Rest Search Results Example

8 fields

EXAMPLE

Jira Cloud Platform Rest Status Category Example

5 fields

EXAMPLE

Jira Cloud Platform Rest Status Details Example

5 fields

EXAMPLE

Jira Cloud Platform Rest Transition Example

7 fields

EXAMPLE

Jira Cloud Platform Rest Transition Ref Example

1 fields

EXAMPLE

Jira Cloud Platform Rest Transitions Example

2 fields

EXAMPLE

Jira Cloud Platform Rest User Details Example

7 fields

EXAMPLE

Jira Cloud Platform Rest Version Example

10 fields

EXAMPLE

Jira Cloud Platform Rest Visibility Example

3 fields

EXAMPLE

Jira Cloud Platform Rest Votes Example

3 fields

EXAMPLE

Jira Cloud Platform Rest Watches Example

3 fields

EXAMPLE

Jira Cloud Platform Rest Worklog Example

7 fields

EXAMPLE

Scroll for all 44

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Jira Authentication

http/oauth2 · 3 schemes

SECURITY

Jira Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Jira Vulnerability Disclosure

security.txt · contact published

SECURITY

Jira Trust Center

FedRAMP

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Jira Scopes

5 scopes · authorizationCode

5 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Jira Agentic Access

16 operations · 6 acting

AGENTIC

Use Cases 5

What developers build with this provider.

Issue Tracking Automation

Automate issue creation, assignment, and transitions based on external events from CI/CD pipelines, monitoring tools, or customer feedback systems.

Sprint Management

Programmatically manage sprints, backlogs, and board configurations for automated agile workflow orchestration.

Service Desk Integration

Integrate customer support channels with Jira Service Management for automated ticket creation and SLA tracking.

Incident Management

Automate incident response workflows with on-call scheduling, alert routing, and escalation management.

Enterprise Agile Planning

Connect portfolio planning tools with Jira Align for cross-team dependency tracking and program-level reporting.

Integrations 5

Pre-built integrations with other platforms and tools.

Confluence

Link Jira issues to Confluence pages for seamless knowledge management and documentation alongside project tracking.

Bitbucket

Connect code repositories to Jira issues for automated status updates, smart commits, and development tracking.

GitHub

Link GitHub pull requests, branches, and commits to Jira issues for end-to-end development visibility.

Slack

Create and manage Jira issues from Slack channels with bi-directional notifications and status updates.

Microsoft Teams

Receive Jira notifications and manage issues directly from Microsoft Teams conversations.

Resources

Get Started 2

Portal, sign-up, and the first successful call

Portal

Portal

GettingStarted

GettingStarted

Documentation 2

Reference material describing how the API behaves

JSONSchema

JSONSchema

JSONSchema

JSONSchema

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

WellKnown

MCPServer

LLMsTxt

AgenticAccess

Design & Contract 17

Pagination, idempotency, versioning, errors, and events

Conformance

ErrorCatalog

Lifecycle

Conventions

Components

DataModel

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

JSONLD

Scroll for all 17

Build 4

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

Packages

CLI

SDKs

Access & Security 8

Authentication, authorization, and security posture

SecurityTxt

SecurityTxt

TrustCenter

TrustCenter

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

Authentication

OAuthScopes

OAuth 2.0

Security

Scroll for all 8

Operate 5

Status, limits, changes, and where to get help

ChangeLog

Support

StatusPage

ChangeLog

RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 1

The organization behind the API

Blog

Blog

Other 2

Properties that don't map to a standard resource type

Overlay

Overlay

Marketplace

Marketplace

Source (apis.yml)

name: Jira
description: APIs for Atlassian Jira project management and issue tracking platform.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://www.atlassian.com/dam/jcr:e33efd9e-e0b8-4d61-a24d-68a48ef9bbe4/jira-icon-blue.svg
url: https://www.atlassian.com/software/jira
created: '2024'
modified: '2026-06-20'
specificationVersion: '0.18'
tags:
- Agile
- Issue Tracking
- ITSM
- Project Management
- Service Management
apis:
- name: Jira Cloud Platform REST API v2
  description: Version 2 of the Jira Cloud platform REST API, offering the same operations as v3 but without Atlassian Document
    Format support.
  image: https://www.atlassian.com/dam/jcr:e33efd9e-e0b8-4d61-a24d-68a48ef9bbe4/jira-icon-blue.svg
  humanURL: https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/
  baseURL: https://your-domain.atlassian.net/rest/api/2
  tags:
  - Issues
  - Legacy
  - Project Management
  - Projects
  - Workflows
  properties:
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/platform/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
- name: Jira Service Management Operations REST API
  description: Operations APIs for Jira Service Management covering schedules, on-call rotations, alerts, escalations, and
    incident management.
  image: https://www.atlassian.com/dam/jcr:e33efd9e-e0b8-4d61-a24d-68a48ef9bbe4/jira-icon-blue.svg
  humanURL: https://developer.atlassian.com/cloud/jira/service-desk-ops/introduction/introduction/
  baseURL: https://api.atlassian.com/jsm/ops/api/{cloudId}
  tags:
  - Alerts
  - Escalations
  - Incidents
  - On-Call
  - Operations
  - Schedules
  properties:
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/intro/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/service-desk-ops/security/basic-auth-for-rest-apis/
- name: Jira Align REST API
  description: REST API for Jira Align enterprise agile planning platform, providing access to portfolios, epics, features,
    and program management data.
  image: https://www.atlassian.com/dam/jcr:e33efd9e-e0b8-4d61-a24d-68a48ef9bbe4/jira-icon-blue.svg
  humanURL: https://help.jiraalign.com/hc/en-us/articles/360045371954-Getting-started-with-the-REST-API-2-0
  baseURL: https://your-domain.jiraalign.com/rest/align/api/2
  tags:
  - Enterprise Agile
  - Planning
  - Portfolios
  - Program Management
  - SAFe
  properties:
  - type: Documentation
    url: https://help.jiraalign.com/hc/en-us/sections/360008049974-API-2-0
  - type: GettingStarted
    url: https://help.jiraalign.com/hc/en-us/articles/360045371954-Getting-started-with-the-REST-API-2-0
  - type: RateLimits
    url: https://help.jiraalign.com/hc/en-us/articles/360045371954-Getting-started-with-the-REST-API-2-0
  - type: Authentication
    url: https://help.jiraalign.com/hc/en-us/articles/360045371954-Getting-started-with-the-REST-API-2-0
- name: Jira Customer Service Management REST API
  description: REST API for Atlassian Customer Service Management providing access to customers, organizations, products,
    and entitlements data.
  image: https://www.atlassian.com/dam/jcr:e33efd9e-e0b8-4d61-a24d-68a48ef9bbe4/jira-icon-blue.svg
  humanURL: https://developer.atlassian.com/cloud/customer-service-management/
  baseURL: https://your-domain.atlassian.net
  tags:
  - Customer Service
  - Customers
  - Entitlements
  - Organizations
  properties:
  - type: Documentation
    url: https://developer.atlassian.com/cloud/customer-service-management/rest/v1/api-group-customer/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/customer-service-management/apis/narratives/authentication/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/customer-service-management/
- aid: jira:jira-issue-comments-api
  name: Jira Issue Comments API
  description: Manage comments on issues.
  humanURL: https://developer.atlassian.com/cloud/jira/platform/
  baseURL: https://your-domain.atlassian.net/rest/api/3
  tags:
  - Issue Comments
  properties:
  - type: OpenAPI
    url: openapi/jira-issue-comments-api-openapi.yml
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
  - type: AsyncAPI
    url: asyncapi/jira-webhooks-asyncapi.yml
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
  - type: RateLimits
    url: https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/platform/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/platform/getting-started/
  - type: GraphQL
    url: graphql/jira-graphql.md
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/
  - type: CodeExamples
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/software/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/service-desk/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/service-desk/security-overview/
- aid: jira:jira-issue-priorities-api
  name: Jira Issue Priorities API
  description: Retrieve issue priority levels.
  humanURL: https://developer.atlassian.com/cloud/jira/platform/
  baseURL: https://your-domain.atlassian.net/rest/api/3
  tags:
  - Issue Priorities
  properties:
  - type: OpenAPI
    url: openapi/jira-issue-priorities-api-openapi.yml
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
  - type: AsyncAPI
    url: asyncapi/jira-webhooks-asyncapi.yml
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
  - type: RateLimits
    url: https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/platform/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/platform/getting-started/
  - type: GraphQL
    url: graphql/jira-graphql.md
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/
  - type: CodeExamples
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/software/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/service-desk/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/service-desk/security-overview/
- aid: jira:jira-issue-search-api
  name: Jira Issue Search API
  description: Search for issues using JQL (Jira Query Language).
  humanURL: https://developer.atlassian.com/cloud/jira/platform/
  baseURL: https://your-domain.atlassian.net/rest/api/3
  tags:
  - Issue Search
  properties:
  - type: OpenAPI
    url: openapi/jira-issue-search-api-openapi.yml
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
  - type: AsyncAPI
    url: asyncapi/jira-webhooks-asyncapi.yml
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
  - type: RateLimits
    url: https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/platform/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/platform/getting-started/
  - type: GraphQL
    url: graphql/jira-graphql.md
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/
  - type: CodeExamples
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/software/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/service-desk/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/service-desk/security-overview/
- aid: jira:jira-issue-statuses-api
  name: Jira Issue Statuses API
  description: Retrieve issue statuses.
  humanURL: https://developer.atlassian.com/cloud/jira/platform/
  baseURL: https://your-domain.atlassian.net/rest/api/3
  tags:
  - Issue Statuses
  properties:
  - type: OpenAPI
    url: openapi/jira-issue-statuses-api-openapi.yml
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
  - type: AsyncAPI
    url: asyncapi/jira-webhooks-asyncapi.yml
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
  - type: RateLimits
    url: https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/platform/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/platform/getting-started/
  - type: GraphQL
    url: graphql/jira-graphql.md
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/
  - type: CodeExamples
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/software/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/service-desk/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/service-desk/security-overview/
- aid: jira:jira-issue-transitions-api
  name: Jira Issue Transitions API
  description: Retrieve and perform workflow transitions on issues.
  humanURL: https://developer.atlassian.com/cloud/jira/platform/
  baseURL: https://your-domain.atlassian.net/rest/api/3
  tags:
  - Issue Transitions
  properties:
  - type: OpenAPI
    url: openapi/jira-issue-transitions-api-openapi.yml
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
  - type: AsyncAPI
    url: asyncapi/jira-webhooks-asyncapi.yml
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
  - type: RateLimits
    url: https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/platform/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/platform/getting-started/
  - type: GraphQL
    url: graphql/jira-graphql.md
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/
  - type: CodeExamples
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/software/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/service-desk/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/service-desk/security-overview/
- aid: jira:jira-issue-types-api
  name: Jira Issue Types API
  description: Retrieve and manage issue types for projects.
  humanURL: https://developer.atlassian.com/cloud/jira/platform/
  baseURL: https://your-domain.atlassian.net/rest/api/3
  tags:
  - Issue Types
  properties:
  - type: OpenAPI
    url: openapi/jira-issue-types-api-openapi.yml
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
  - type: AsyncAPI
    url: asyncapi/jira-webhooks-asyncapi.yml
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
  - type: RateLimits
    url: https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/platform/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/platform/getting-started/
  - type: GraphQL
    url: graphql/jira-graphql.md
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/
  - type: CodeExamples
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/software/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/service-desk/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/service-desk/security-overview/
- aid: jira:jira-issues-api
  name: Jira Issues API
  description: Create, read, update, delete, and transition Jira issues.
  humanURL: https://developer.atlassian.com/cloud/jira/platform/
  baseURL: https://your-domain.atlassian.net/rest/api/3
  tags:
  - Issues
  properties:
  - type: OpenAPI
    url: openapi/jira-issues-api-openapi.yml
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
  - type: AsyncAPI
    url: asyncapi/jira-webhooks-asyncapi.yml
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
  - type: RateLimits
    url: https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/platform/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/platform/getting-started/
  - type: GraphQL
    url: graphql/jira-graphql.md
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/
  - type: CodeExamples
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/software/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/service-desk/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/service-desk/security-overview/
- aid: jira:jira-projects-api
  name: Jira Projects API
  description: Manage Jira projects including metadata, roles, and components.
  humanURL: https://developer.atlassian.com/cloud/jira/platform/
  baseURL: https://your-domain.atlassian.net/rest/api/3
  tags:
  - Projects
  properties:
  - type: OpenAPI
    url: openapi/jira-projects-api-openapi.yml
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
  - type: AsyncAPI
    url: asyncapi/jira-webhooks-asyncapi.yml
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
  - type: RateLimits
    url: https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/platform/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/platform/getting-started/
  - type: GraphQL
    url: graphql/jira-graphql.md
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/
  - type: CodeExamples
    url: https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/software/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: GettingStarted
    url: https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
  - type: Authentication
    url: https://developer.atlassian.com/cloud/jira/software/security-overview/
  - type: Documentation
    url: https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
  - type: ChangeLog
    url: https://developer.atlassian.com/cloud/jira/service-desk/changelog/
  - type: Security
    url: https://developer.atlassian.com/cloud/jira/service-desk/security-overview/
maintainers:
- name: Atlassian
  email: ecosystem@atlassian.com
  url: https://www.atlassian.com
- name: Kin Lane
  email: kin@apievangelist.com
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/jira/overview
- type: Packages
  url: packages/jira-packages.yml
- type: WellKnown
  url: well-known/jira-well-known.yml
- type: SecurityTxt
  url: well-known/jira-security.txt
- type: MCPServer
  url: mcp/jira-mcp.yml
  name: Atlassian Rovo MCP Server
- type: LLMsTxt
  url: llms/jira-llms.txt
- type: Overlay
  url: overlays/jira-cloud-platform-rest-api-overlay.yaml
- type: Conformance
  url: conformance/jira-conformance.yml
- type: ErrorCatalog
  url: errors/jira-problem-types.yml
- type: Lifecycle
  url: lifecycle/jira-lifecycle.yml
- type: Conventions
  url: conventions/jira-conventions.yml
- type: ChangeLog
  url: changelog/jira-changelog.yml
  name: Jira Cloud Platform Changelog (structured)
- type: CLI
  url: cli/jira-cli.yml
- type: Components
  url: components/jira-components.yml
- type: DataModel
  url: data-model/jira-data-model.yml
- type: AgenticAccess
  url: agentic-access/jira-agentic-access.yml
- type: TrustCenter
  url: security/jira-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/jira-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/jira-domain-security.yml
- type: Authentication
  url: authentication/jira-authentication.yml
- type: OAuthScopes
  url: scopes/jira-scopes.yml
- type: Arazzo
  url: arazzo/jira-comment-thread-reply-workflow.yml
  name: Jira Read an Issue Comment Thread and Reply
- type: Arazzo
  url: arazzo/jira-create-issue-read-back-workflow.yml
  name: Jira Create an Issue and Read It Back
- type: Arazzo
  url: arazzo/jira-deduplicate-issue-intake-workflow.yml
  name: Jira Deduplicate Issue Intake
- type: Arazzo
  url: arazzo/jira-edit-issue-verify-workflow.yml
  name: Jira Edit an Issue and Verify the Change
- type: Arazzo
  url: arazzo/jira-issue-metadata-bootstrap-workflow.yml
  name: Jira Bootstrap Issue Creation Metadata
- type: Arazzo
  url: arazzo/jira-jql-issue-report-workflow.yml
  name: Jira Run a JQL Report and Drill Into a Result
- type: Arazzo
  url: arazzo/jira-project-discovery-workflow.yml
  name: Jira Discover a Project and Its Workflow Statuses
- type: Arazzo
  url: arazzo/jira-safe-issue-delete-workflow.yml
  name: Jira Safely Delete an Issue
- type: Arazzo
  url: arazzo/jira-stale-issue-sweep-workflow.yml
  name: Jira Sweep a Stale Issue Through a Transition
- type: Arazzo
  url: arazzo/jira-transition-issue-workflow.yml
  name: Jira Transition an Issue to a New Status
- type: Portal
  url: https://developer.atlassian.com/cloud/jira/platform/
- type: GettingStarted
  url: https://developer.atlassian.com/cloud/jira/platform/getting-started/
- type: SDKs
  url: https://developer.atlassian.com/cloud/jira/platform/libraries/
- type: Authentication
  url: https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/
  title: OAuth 2.0
- type: Support
  url: https://support.atlassian.com/
- type: StatusPage
  url: https://status.atlassian.com/
- type: TermsOfService
  url: https://www.atlassian.com/legal/cloud-terms-of-service
- type: PrivacyPolicy
  url: https://www.atlassian.com/legal/privacy-policy
- type: ChangeLog
  url: https://developer.atlassian.com/changelog/
- type: Blog
  url: https://www.atlassian.com/blog/developer
- type: Marketplace
  url: https://developer.atlassian.com/platform/marketplace/getting-started/
- type: RateLimits
  url: https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
- type: Security
  url: https://developer.atlassian.com/cloud/jira/platform/security-overview/
- type: JSONSchema
  url: json-schema/jira-issue-schema.json
  name: Jira Issue Schema
- type: JSONSchema
  url: json-schema/jira-project-schema.json
  name: Jira Project Schema
- type: JSONLD
  url: json-ld/jira-context.jsonld
  name: Jira JSON-LD Context
- type: Features
  data:
  - 'Free: up to 10 users'
  - 'Standard: $7.91-$9.05/user/mo (volume tiered)'
  - 'Premium: $14.54-$18.30/user/mo with Advanced Roadmaps'
  - 'Enterprise custom: Atlassian Intelligence, 99.95% uptime, data residency'
  - 'Volume discount: rates drop above 100 users (max 50K)'
  - REST API v3 at api.atlassian.com
  - GraphQL API for some products
  - Token-bucket rate limit ~10 req/sec/app/user
  - Bulk operations max 100 items/request
  - Webhooks v3 for issue/project events
  - OAuth 2.0 (3LO) and API tokens
  - Atlassian Connect framework for marketplace apps
  - Forge for serverless app development
  - JQL (Jira Query Language) for advanced search
  - Atlassian Intelligence AI assistant (Enterprise)
  - Cross-product Analytics + Atlas integrations
  sources:
  - https://www.atlassian.com/software/jira/pricing
  updated: '2026-05-04'
- type: UseCases
  data:
  - name: Issue Tracking Automation
    description: Automate issue creation, assignment, and transitions based on external events from CI/CD pipelines, monitoring
      tools, or customer feedback systems.
  - name: Sprint Management
    description: Programmatically manage sprints, backlogs, and board configurations for automated agile workflow orchestration.
  - name: Service Desk Integration
    description: Integrate customer support channels with Jira Service Management for automated ticket creation and SLA tracking.
  - name: Incident Management
    description: Automate incident response workflows with on-call scheduling, alert routing, and escalation management.
  - name: Enterprise Agile Planning
    description: Connect portfolio planning tools with Jira Align for cross-team dependency tracking and program-level reporting.
- type: Integrations
  data:
  - name: Confluence
    description: Link Jira issues to Confluence pages for seamless knowledge management and documentation alongside project
      tracking.
  - name: Bitbucket
    description: Connect code repositories to Jira issues for automated status updates, smart commits, and development tracking.
  - name: GitHub
    description: Link GitHub pull requests, branches, and commits to Jira issues for end-to-end development visibility.
  - name: Slack
    description: Create and manage Jira issues from Slack channels with bi-directional notifications and status updates.
  - name: Microsoft Teams
    description: Receive Jira notifications and manage issues directly from Microsoft Teams conversations.