Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
    6. Status pages
    7. Metadata
    8. Integrations
      1. New Relic
      2. Datadog
      3. AWS CloudWatch
      4. Amazon SNS
      5. Microsoft Azure
      6. Google Monitoring
      7. Grafana
      8. Elastic
      9. Prometheus
      10. E-mail
      11. Incoming webhooks
      12. Atlassian Jira
        1. List Jira integrations GET
        2. Get Jira integration GET
        3. Update Jira integration PATCH
      13. Slack
      14. Outgoing webhooks
      15. Outgoing e‑mails
      16. Splunk On-Call
      17. PagerDuty
      18. Catalog
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Get Jira integration

Returns a single Jira integration by ID.

GET https://incidents.betterstack.com/api/v2/jira-integrations/:jira_integration_id

URL parameters

jira_integration_id
required string

The ID of the Jira integration you want to get.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a single Jira integration.

Response body

{
  "data": {
    "id": "13760",
    "type": "jira_integration",
    "attributes": {
      "name": "Test",
      "automatic_issue_creation": false,
      "jira_project_key": "TP",
      "jira_issue_type_id": "10006",
      "jira_fields": {
        "labels": [
          {
            "label": "example-label",
            "value": "example-label"
          }
        ],
        "assignee": {
          "label": "John Doe",
          "value": "1234567890"
        },
        "reporter": {
          "label": "John Doe",
          "value": "1234567890"
        },
        "customfield_10015": 3,
        "customfield_10021": [
          {
            "label": "Impediment",
            "value": "10019"
          }
        ]
      },
      "team_name": "Test Team"
    }
  }
}

Response attributes

id
string

The ID of the Jira integration.

type
string

Always jira_integration.

attributes.name
string or null

The name of the Jira integration shown in the dashboard.

attributes.automatic_issue_creation
boolean

Whether the integration creates Jira issues for new incidents automatically.

attributes.jira_project_key
string or null

The key of the target Jira project, such as ABC for issues like ABC-123.

attributes.jira_issue_type_id
string or null

The ID of the target Jira issue type.

attributes.jira_fields
object

The values used for new Jira issues, keyed by Jira field id, as described in updating Jira issue fields.

attributes.team_name
string

The team this integration belongs to.

Example cURL

Example
curl --request GET \
  --url https://incidents.betterstack.com/api/v2/jira-integrations/13760 \
  --header "Authorization: Bearer $TOKEN"


Previous article

List Jira integrations

Next article

Update Jira integration