---
title: "Fetch the GitHub<>JIRA user identity mapping."
method: GET
path: "/settings/jira/identities/{id}"
tags: ["settings", "default"]
---

# Fetch the GitHub<>JIRA user identity mapping.

`GET /settings/jira/identities/{id}`

## Request

- Base URL: `{{ server_url }}/v1`
- URL: `{{ server_url }}/v1/settings/jira/identities/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/athenian/apis/title/docs/settings/jira/identities/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Response `200`

List with the Github<>JIRA identity mapping.

- MappedJIRAIdentity[]: List of currently mapped GitHub<>JIRA users. Additionally, we include unmapped JIRA users to provide a complete list of them.
  - `developer_id` union, required
    - string: User name which uniquely identifies any developer on any service provider. The format matches the profile URL without the protocol part.
    - string, nullable
  - `developer_name` string, nullable, required: Full name of the mapped GitHub user.
  - `jira_name` string, required: Full name of the mapped JIRA user.
  - `confidence` number, float, required: Value from 0 to 1 indicating how similar are the users.

## Other responses

- `400`: Request is invalid.
- `403`: The user is not an admin of this account.
- `404`: The user or the account was not found.
- `422`: The JIRA installation does not exist.

---

[API](https://skmtc.dev/athenian/apis/title.md) - [All operations](https://skmtc.dev/athenian/apis/title/llms.txt) - [OpenAPI document](https://skmtc.dev/athenian/apis/title/revisions/110c9f7cffdd?raw)