# Jira Cloud API

**Provider:** Atlassian
**Category:** developer
**Base URL:** `https://{your-domain}.atlassian.net/rest/api/3`
**Auth:** basic — `Authorization: Basic base64(email@example.com:YOUR_API_TOKEN)`
**Rate Limit:** 400 requests/min (authenticated user)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developer.atlassian.com/cloud/jira/platform/rest/v3/

## Description

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.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://{your-domain}.atlassian.net/rest/api/3/issue/{issueKey}` | Get a single issue with all fields |
| POST | `https://{your-domain}.atlassian.net/rest/api/3/issue` | Create a new issue in a project |
| PUT | `https://{your-domain}.atlassian.net/rest/api/3/issue/{issueKey}` | Update issue fields |
| POST | `https://{your-domain}.atlassian.net/rest/api/3/issue/{issueKey}/transitions` | Transition an issue through the workflow |
| POST | `https://{your-domain}.atlassian.net/rest/api/3/issue/picker` | Search issues with JQL (Jira Query Language) |
| GET | `https://{your-domain}.atlassian.net/rest/api/3/project` | List all projects accessible to the user |

## Authentication

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)
```

## Sample Request

```bash
curl "https://mycompany.atlassian.net/rest/api/3/issue/picker?query=status%3D'In+Progress'&currentJQL=project%3DMYPROJ" \
  -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
  -H "Accept: application/json"
```

## Sample Response

```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"
    }]
  }]
}
```

## Pricing Details

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.

---

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