Shorter Loop API Documentation
API ReferencesRelease NotesHelp CenterKnowledge Base
API ReferencesRelease NotesHelp CenterKnowledge Base
Sign In
  1. User stories
  • Getting started
    • Welcome to the Shorter Loop API Portal
    • Authentication
    • Base URL
    • 2 way Jira Integration
    • Create webhook in Shorter Loop
  • Metrics
    • Create a Key Performance Indicator (KPI)
      POST
    • Update the Key Performance Indicator (KPI)
      PUT
    • Retrieve KPIs not linked to specific product backlog items
      GET
    • Insert KPI's records (Body JSON Payload)
      POST
    • Insert KPI's records (Upload CSV)
      POST
    • Insert KPI's records (Upload JSON)
      POST
  • Idea manager
    • Feedback Collection
      • Create idea and issue
      • Retrieves a list of categories
      • Modify feedback item
      • Removes a feedback item
      • Upvote or downvote a work item
      • Retrieve a feedback item
      • Get comments for a feedback item.
      • Reply to a comment
      • Modify a comment
      • Bulk create feedback items: CSV and JSON
    • Segments
      • Retrieves a list of segments without users
      • Create segment
      • Modify a segment
      • Removes a segment
      • Bulk create users to a segment
      • Manage user segments: move or remove
      • Retrieve segments with users
      • Retrieve segment with users
      • Import Users (CSV/JSON)
      • Sending email to segment members
      • Sending email to selected idm members
    • Bulk create idea manager members
      POST
    • Import Users (CSV/JSON) in IDM
      POST
    • Bulk re-invite in IDM
      PUT
  • Backlog Management
    • Epics
      • Create a new epic
      • Modify an epic
      • Retrieve details of the epic
      • Removes the epic
    • Features
      • Create a new feature
      • Modify a feature
      • Retrieve details of the feature
      • Removes the feature
    • User stories
      • Create a new user story
        POST
      • Modify a user story
        PUT
      • Retrieve user story
        GET
      • Removes the user story
        DELETE
    • Assets
      • Attaches files to the workitem
      • Removes an asset
      • Retrieve attachments for the backlog workitem with ID
    • Product Tags
      • Retrieves tags for initiative
    • Teams
      • Get teams and members for product
    • Personas
      • Retrieve personas associated with initiative
    • Get whole backlog tree
      GET
  • Strategy Board
    • Experiment
      • Create a new experiemnt variant
    • Solutions
      • Versions
        • Storymap versions api documentation
        • Create a version
        • Update version
        • Removes a version
        • Retrieve versions
      • Get all storymaps for solution
  • Persona Board V2
    • Segments
      • Permanently deletes a segment
      • Creates a new option
      • Retrieve a list of segments
      • Retrieve a segment
      • Create a segment
      • Removes a segment
      • Removes a segment option
      • Detaches a segment from the persona
      • Update segment option
    • Custom fields
      • Removes a custom field
      • Retrieve a list of custom fields
      • Retrieve a custom field
      • Create a custom field
      • Removes a custom field option
      • Detaches a custom field from persona
      • Retrieve custom fields excluding persona
      • Creates a new option
      • Permanently deletes a custom field
      • Update custom field
      • Update custom field option
      • Attach a custom field to a persona
    • Create opportunities from summary
    • Retrieve notes
    • Retrieve persona
    • Retrieve experiments for Persona
    • Create
    • Retrieve
  • DocsHub
    • Retrieve categories with templates
    • Retrieve a template based on category
    • Create copy of template while using template
  1. User stories

Retrieve user story

GET
/api/initiatives/SHO-MJXR/user-story/US-19
Retrieve details of the user story identified by US-19 from the initiative with external key SHO-MJXR.
Notes:
Ensure that a valid authentication token is provided in the request headers.
Ensure that you provide right userstory external key

Request

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.shorterloop.com/api/initiatives/SHO-MJXR/user-story/US-19' \
--header 'Authorization;' \
--header 'initiativeId;'

Responses

🟢200Success
application/json
Body

Example
{
    "userStory": {
        "id": -15239386,
        "summary": "officia Excepteur laboris fugiat",
        "description": "At eveniet tenetur est. Ex eius suscipit dolore iusto expedita illo. Reiciendis amet quaerat earum aut ratione expedita.",
        "order": -53012668,
        "externalKey": "ut eiusmod aliquip",
        "color": "plum",
        "initiativeId": "voluptate ullamco exercitation sed minim",
        "backlog": true,
        "progress": "aliquip in nulla pariatur do",
        "tags": "a",
        "timeBoxPlanningId": 32376076,
        "businessObjectiveId": 33284982,
        "businessGoal": "labore ea",
        "dueDate": null,
        "remainingTime": "2024-07-11T05:00:08.851Z",
        "storyPoint": -40723231,
        "featureId": -11518767,
        "persona": [
            {
                "personaValue": "eu Ut nostrud aliquip",
                "personaId": -4585867
            },
            {
                "personaValue": "aute adipisicing laboris id pariatur",
                "personaId": 59111262
            }
        ],
        "epicId": -12222018,
        "teamId": null,
        "urls": "reprehenderit non incididunt aliqua",
        "userId": [
            62098406
        ],
        "startDate": "2024-07-11T22:57:25.887Z",
        "endDate": "2024-07-11T19:12:59.640Z",
        "externalProgress": "deserunt elit aliqua cillum",
        "kpis": [
            "quis commodo enim",
            "ut sint pariatur labore nisi",
            "esse ut Ut eu cupidatat"
        ]
    },
    "owner": {
        "id": 74812996,
        "email": "Damon.Hessel9@yahoo.com",
        "firstName": "Elenora",
        "lastName": "Gutkowski",
        "displayName": "sint ex modi",
        "timeZoneAbbr": null,
        "profileImage": "https://loremflickr.com/640/480/nature",
        "provider": "consectetur Ut sit aliqua",
        "role": "commodo enim voluptate occaecat",
        "group": true,
        "bio": null
    }
}
Modified at 2024-07-15 04:47:28
Previous
Modify a user story
Next
Removes the user story
Built with