Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This is a Singer tap that produces JSON-formatted data following the Singer spec.

This tap:

Quick Start

  1. Install

    pip install tap-jira

  2. Create the config file

    Create a JSON file called config.json. Its contents should look like (for Basic Auth):

         "start_date": "2010-01-01",
         "username": "your-jira-username",
         "password": "your-jira-password",
         "base_url": "https://your-jira-domain",
         "user_agent": "<user-agent>",
         "request_timeout": 300,
         "groups": "jira-administrators, site-admins, jira-software-users"

    or (for OAuth):

      "oauth_client_secret": "<oauth-client-secret>",
      "user_agent": "<user-agent>",
      "oauth_client_id": "<oauth-client-id>",
      "access_token": "<access-token>",
      "cloud_id": "<cloud-id>",
      "refresh_token": "<refresh-token>",
      "start_date": "<i.e. 2017-12-04T19:19:32Z>",
      "request_timeout": 300,
      "groups": "jira-administrators, site-admins, jira-software-users"

    The start_date specifies the date at which the tap will begin pulling data (for those resources that support this).

    For Basic Auth, the base_url is the URL where your Jira installation can be found. For example, it might look like:

    The groups specifies groups for users stream. It is an optional parameter. Default value is ["jira-administrators", "jira-software-users", "jira-core-users", "jira-users", "users"].

  3. Run the Tap in Discovery Mode

    tap-jira -c config.json -d

    See the Singer docs on discovery mode here.

  4. Run the Tap in Sync Mode

    tap-jira -c config.json -p catalog-file.json

Copyright © 2017 Stitch