Get KR details

API URL to get KR details 

Use below endpoint to get KR details. 

  • Syntax - <Jira base URL>/rest/amoeboids-upraise/1.0/okr/keyresult/{key result id}

  • Example - jira.amoeboids.com/rest/amoeboids-upraise/1.0/okr/keyresult/1

This API returns data about a key result. If the key result is deleted or its id is incorrect, relevant message is returned. 

Request

Key result id is needed as input in the endpoint url.

Response 

Parent

Parameter

Type

Description

Possible values



id

Number

KR id in UpRaise

12,45,78, etc



key

String

KR key in UpRaise

KR-12, KR-45, KR-78, etc



type

Object

This object consists of details about KR types available in UpRaise that is relevant to the given KR id. 

  • id

  • name

type

id

Number

Key result type id.

1,2

type

name

String

Key result name in UpRaise.

  • Metric

  • Todo



title

String

Key result title.

  • Increase CSAT rate from 60%-70% 

  • Complete Jira administration certification by end of this year



description

String

Key result description.

  • Hire a Chief Revenue Officer

  • Increase repeat sales by 7% year on year



owner

String

Key result owner name.

Any UpRaise user's name who owns the current key result.



originalValue

Number

Original value for a metric type key result.

10,20,20.80, etc



targetValue

Number

Target value for a metric type key result.

50, 500, 52.58, etc 



currentValue

Number

Current value for a metric type key result. 

25, 52.58,900, etc



progress

Object

This object consists of details about progress of the current key result.

  • percent

progress

percent

Number

This returns the current progress of the key result.

20.0,30.0,56.85, etc



confidenceStatus

Object

This object consists of details about the confidence status of the key result's parent objective. 

  • id

  • name

confidenceStatus

id

Number

Confidence status type id in UpRaise.

1,2,3,4,5, etc

confidenceStatus

name

String

Confidence display name in UpRaise.

  • On track 

  • Lagging

  • At risk

  • Not applicable

  • Not available

(First three confidence statuses are customizable and can be anything as per user requirements, last two are system default)

progress

confidenceScore

Number

Any number from 0-10. Only non-decimal numbers. 

  • 0-4

  • 5-7

  • 8-10



dueDate

Date

Due date of the key result.

08/Jan/18 



weightage

Number

Any non-decimal number between 0-10 as weight of the key result, in relation to its parent objective.

Any non-decimal number between 0-10



orderIndex

Number

Priority of the current key result as compared to other KRs under its parent objective.

  • 1

  • 2

  • 3

  • etc



lastPunchedIn

Date

Date & time on which this KR was last punched in.

08/Jan/18 8:36 PM



parentObjective

Object

This objective consists details of parent objective of the current KR.



parentObjective

id

Number

Objective id of parent objective of the KR

120, 45, etc

parentObjective

key

String

Objective key of parent objective of the KR

OBJ -120, OBJ - 45, etc

parentObjective

title

String

Objective title of parent objective of the KR

Title of the objective

parentObjective

description

String

Objective description of parent objective of the KR

Description of the objective

parentObjective

objectiveCycle

Object

This object consists of details about cycle of the parent objective in UpRaise instance.



objectiveCycle

id

Number

Objective cycle id in UpRaise.

1,2,56,70, etc

objectiveCycle

name

String

User facing objective cycle name.

  • March-May 2019

  • July-sept 2019

  • etc

parentObjective

level

Object

This object consists of data points that are available about the objective levels within UpRaise.



level

id

Number

Level id of the parent objective of respective KR. 

1,2,3,4, etc

level

name

String

Level name of the parent objective of respective KR. 

  • Individual

  • Team

  • Company

  • Above are the default objective level display names, UpRaise admins can add their own display names in their Upraise instances. 

parentObjective

owner

String

Objective owner name in UpRaise

Name of UpRaise user

parentObjective

upRaiseInfo

Object

This object consists of data points that are available about the user within UpRaise's company directory.

  • ownerDesignation

  • id

  • name

upRaiseInfo

ownerDesignation

Object

This object consists of data points that are available about the user's designation within UpRaise's company directory.



upRaiseInfo

id

Number

Designation id in UpRaise's company directory

1, 2, 3, 4.,etc

upRaiseInfo

name

String

User facing designation in UpRaise's company directory.

  • Software developer

  • QA Engineer

  • etc

upRaiseInfo

ownerTeams

Object

This object consists of data points that are available about the user's team within UpRaise's company directory.

  • id

  • name

ownerTeams

id

Number

Team id in UpRaise company directory.

1,2,3,4, etc

ownerTeams

name

String

User facing team name in UpRaise's company directory

Sales, Operations, Human resources, Software development, etc

parentObjective

startDate

Date

Start date of the parent objective.

08/Jan/18 

parentObjective

dueDate

Date

Due date of the parent objective.

08/Jan/18 

parentObjective

status

Object

This object consists of details about objective statuses in UpRaise



status

id

Number

Objective status id

1,2,3,4, etc

status

name

String

Objective status name in UpRaise

  • Ready

  • In progress

  • Closed

  • Abandoned

  • Ready for grading

  • Ready to close

  • Carry forwarded

  • Scheduled

parentObjective

progress

Object

This object cosists of details about current progress percent of the parent objective in UpRaise. 

  • percent

progress

percent

Number

Progress of parent objective

50.0, 60.0, 85.5, etc

progress

confidenceStatus

String

Confidence status display name in UpRaise (confidence status of parent objective).

  • On track 

  • Lagging

  • At risk

  • Not applicable

  • Not available

(First three confidence statuses are customizable and can be anything as per user requirements, last two are system default)

confidenceStatus

id

Number

Confidence status type id in UpRaise.

1,2,3,4, etc

confidenceStatus

name

String

Confidence status type name in UpRaise.

  • On track 

  • Lagging

  • At risk

  • Not applicable

  • Not available

(First three confidence statuses are customizable and can be anything as per user requirements, last two are system default)

progress

confidenceScore

Number

Any number from 0-10. Only non-decimal numbers. 

0,1,2,3.....10

parentObjective

labels

String

Objective labels

Labels are customizable, it can be anything that is used by UpRaise users to classify their objective. Example - CSAT, team building, etc

labels

id

Number

Objective labels ids

1, 2, 3, 4, etc

labels

name

String

Objective labels names

Motivation, Teamwork, etc. (Any label used by UpRaise users for classification of oobjectives)



attachments

Object

This object consists of details about all file attachments to the current KR.



attachments

id

Number

Id of the attachment.



attachments

creator

String

UpRaise user name of attachment creator 

User name of UpRaise

attachments

created

Date

Date on which the file was attached with KR in UpRaise

08/Jan/18 8:36 PM

attachments

fileName

String

Filename of the attachment

Any file name

attachments

mimeType

String

Mime type of the attached file



attachments

size

Number

Size of the attachment in KB

1024



totalActions

Number

Number of Jira issue actions in KR of UpRaise objective

1,5,10, etc



gradeApiUrl

String

Url endpoint to retrieve grades associated with this key result.

For example - 

jira.amoeboids.com/rest/amoeboids-upraise/1.0/okr/keyresult/100/getgrades



dateTimeFormat

String

Format definition of date fields returned in response.





dateFormat

Date

Format definition of date fields returned in response.