The Jira Cloud REST API provides full programmatic access to Jira's issue tracking and project management features. Create and update issues with custom fields, run JQL (Jira Query Language) searches, manage sprints and agile boards, handle transitions through workflows, set up webhooks for real-time events, manage user permissions and project configurations, and generate reports. Essential for CI/CD integrations, release tracking, and custom project tooling.
https://{your-domain}.atlassian.net/rest/api/3
Auth type
Basic Auth
Auth header
Authorization: Basic base64(email@example.com:YOUR_API_TOKEN)
Rate limit
400 requests/min (authenticated user)
Pricing
Free tier available
Free quota
Free for up to 10 users
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/
Endpoint status
Unreachable — No response — server may be down or blocking automated probes
(checked Mar 29, 2026)
Builder score
C
61%
builder-friendly
Use HTTP Basic Auth with your Atlassian account email as username and an API token as password. Generate tokens at id.atlassian.com/manage-profile/security/api-tokens.
Authorization: Basic base64(email@example.com:YOUR_API_TOKEN)
Free: 10 users, 2GB storage. Standard $8.15/user/mo: 35,000 users, audit logs. Premium $16/user/mo: unlimited storage, advanced roadmaps. Enterprise: custom.
| Method | Path | Description |
|---|---|---|
| GET | /issue/{issueKey} |
Get a single issue with all fields |
| POST | /issue |
Create a new issue in a project |
| PUT | /issue/{issueKey} |
Update issue fields |
| POST | /issue/{issueKey}/transitions |
Transition an issue through the workflow |
| POST | /issue/picker |
Search issues with JQL (Jira Query Language) |
| GET | /project |
List all projects accessible to the user |
curl "https://mycompany.atlassian.net/rest/api/3/issue/picker?query=status%3D'In+Progress'¤tJQL=project%3DMYPROJ" \ -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \ -H "Accept: application/json"
{
"sections": [{
"label": "Current Search",
"issues": [{
"key": "MYPROJ-42",
"summary": "Fix authentication token refresh bug",
"img": "https://mycompany.atlassian.net/images/icons/issuetypes/bug.svg"
}]
}]
}
Data sourced from API Map. Always verify pricing and rate limits against the official Atlassian documentation.