This library eases the use of the Jira REST API from Python and it has been used in production for years.
As this is an open-source project that is community maintained, do not be surprised if some bugs or features are not implemented quickly enough.
Quickstart
Feeling impatient? I like your style.
from jira import JIRA
jira = JIRA('https://jira.atlassian.com')
issue = jira.issue('JRA-9')
print(issue.fields.project.key) # 'JRA'
print(issue.fields.issuetype.name) # 'New Feature'
print(issue.fields.reporter.displayName) # 'Mike Cannon-Brookes [Atlassian]'Installation
Download and install using pip install jira or easy_install jira
You can also try pip install --user --upgrade jira which will install or upgrade jira to your user directory. Or maybe you ARE using a virtualenv right?
By default only the basic library dependencies are installed, so if you want to use the cli tool or other optional dependencies do perform a full installation using pip install jira[opt,cli,test]
Usage
See the documentation for full details.
Development
Development takes place on GitHub using the default repository branch. Each version is tagged.
Setup
Automatic (VS Code)
Follow the instructions in the contributing guide, which will describe how to use the dev container that will automatically setup a suitable environment.
Manual
Install pyenv to install a suitable python version.
- Launch docker jira server
docker run -dit -p 2990:2990 --name jira addono/jira-software-standalone
tox envs
- Lint
tox -e lint
- Run tests
tox
- Build and publish with TWINE
tox -e publish
Jira REST API Reference Links
When updating interactions with the Jira REST API please refer to the documentation below. We aim to support both Jira Cloud and Jira Server / Data Center.
Jira Cloud / Jira Server (main REST API reference)
Jira Software Cloud / Jira Software Server (former names include: Jira Agile, Greenhopper)
Credits
In addition to all the contributors we would like to thank to these companies:
Atlassian for developing such a powerful issue tracker and for providing a free on-demand Jira instance that we can use for continuous integration testing.
GitHub for hosting our continuous integration and our git repo
Navicat for providing us free licenses of their powerful database client GUI tools.
4 maintainers
Release files for jira 3.10.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jira-3.10.5.tar.gz | 105.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jira-3.10.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 185.1 kB
Release files / jira-3.10.5.tar.gz
| Download URL | jira-3.10.5.tar.gz |
|---|---|
| Size | 105.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2d09ae3bf4741a2787dd889dfea5926a5d509aac3b28ab3b98c098709e6ee72d
|
|
BLAKE2b-256 checksum How to use checksums |
6573ee4daa7cf4eea457180de0ea78b730b44bb5ad2829dae49cf708a1460819
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 28, 2025.
Transparency logRelease files / jira-3.10.5-py3-none-any.whl
| Download URL | jira-3.10.5-py3-none-any.whl |
|---|---|
| Size | 79.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d4da1385c924ee693d6cc9838e56a34e31d74f0d6899934ef35bbd0d2d33997f
|
|
BLAKE2b-256 checksum How to use checksums |
8957ad078d7379e390798559446607e413fc953c7510711462ab34194dba5924
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 28, 2025.
Transparency log
