A nodejs wrapper for the JIRA REST API
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 181 commits behind steves:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


JavaScript JIRA API for node.js

A node.js module, which provides an object oriented wrapper for the JIRA REST API.

This library is built to support version 2.0.alpha1 of the JIRA REST API.

JIRA REST API documentation can be found here


Install with the node package manager npm:

$ npm install jira


Install via git clone:

$ git clone git://git://github.com/steves/node-jira.git
$ cd node-jira
$ npm install


Find the status of an issue.

JiraApi = require('jira').JiraApi;

var jira = new JiraApi('https', config.host, config.port, config.user, config.password, '2.0.alpha1');
jira.findIssue(issueNumber, function(error, issue) {
    console.log('Status: ' + issue.fields.status.value.name);

Currently there is no explicit login call necessary as each API call makes a call to login before processing. This causes a lot of unnecessary logins and will be cleaned up in a future version.

Implemented APIs

  • Authentication
  • Pulling an issue
  • Pulling a project
  • Pulling unresolved issues count for a specific version
  • Issue linking
  • Pulling versions
  • Adding a new version


  • API docs
  • Better most methods are currently undocumented
  • Tests
  • Refactor currently implemented APIs to be more Object Oriented
  • Refactor to make use of built-in node.js events and classes
  • Auto-redirect between http and https following headers