See all operations

GET: projects/{project_id}/pull-requests/{pull_request_id}

Description

Retrieves a pull request by its Id (TaskId)

How to Execute

To access this REST web service, you need to use the following URL (make sure to replace any parameters (eg {project_id}) with the relevant value (eg 1):

https://api.inflectra.com/spira/services/v7_0/RestService.svc/projects/{project_id}/pull-requests/{pull_request_id}

Request Parameters

Name	Description
project_id	Project containing the pull request
pull_request_id	TaskId of the pull request to be retrieved

Request Body

Nothing Expected

Nothing Expected

Return Data

The JSON and XML examples below show the shape of one entry that will be returned. It does not show an example of how that entry will be populated.

Property	Description
SourceBranchId	ID of the branch being merged from
SourceBranchName	Name of the branch being merged from
DestBranchId	Id of the branch being merged to
DestBranchName	Name of the branch being merged to
TaskId	The id of the task
TaskStatusId	The id of the status of the task
TaskTypeId	The id of the type of the task (null for default)
TaskFolderId	The of the folder the task is stored in (null for root)
RequirementId	The id of the parent requirement that the task belongs to
ReleaseId	The id of the release/iteration that the task is scheduled for
ReleaseGuid	The guid of the release
ComponentId	The id of the component that this task belongs to Read-only
CreatorId	The id of the user that originally created the task If no value is provided, the authenticated user is used instead
OwnerId	The id of the user that the task is assigned-to
CreatorGuid	The guid of the creator.
OwnerGuid	The guid of the owner.
TaskPriorityId	The id of the priority of the task
Name	The name of the task
Description	The detailed description of the task
CreationDate	The date/time that the task was originally created
LastUpdateDate	The date/time that the task was last modified This field needs to match the values retrieved to ensure data-concurrency
StartDate	The scheduled start date for the task
EndDate	The scheduled end date for the task
CompletionPercent	The completion percentage (value = 0-100) of the task as calculated in the system from the remaining effort vs. the original estimated effort. Read-Only
EstimatedEffort	The originally estimated effort (in minutes) of the task
ActualEffort	The actual effort expended so far (in minutes) for the task
RemainingEffort	The effort remaining as reported by the developer
ProjectedEffort	The projected actual effort of the task when it is completed Read-Only
TaskStatusName	The display name of the status of the task
TaskTypeName	The display name of the type of the task
OwnerName	The display name of the user who the task is assigned-to Read-Only
TaskPriorityName	The display name of the priority of the task Read-Only
ProjectName	The display name of the project the task belongs to Read-Only
ReleaseVersionNumber	The version number of the release/iteration the task is scheduled for Read-Only
RequirementName	The name of the requirement that the task is associated with Read-Only
RiskId	The risk that the task is associated with
ProjectId	The id of the project that the artifact belongs to
ProjectGuid	The guid of the project that the artifact belongs to
ArtifactTypeId	The type of artifact that we have
ConcurrencyDate	The datetime used to track optimistic concurrency to prevent edit conflicts
CustomProperties	The list of associated custom properties/fields for this artifact
IsAttachments	Does this artifact have any attachments?
Tags	The list of meta-tags that should be associated with the artifact
Guid	The unique identifier for the artifact

<RemotePullRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v7_0.DataObjects">
  <ArtifactTypeId>0</ArtifactTypeId>
  <ConcurrencyDate>0001-01-01T00:00:00</ConcurrencyDate>
  <CustomProperties i:nil="true" />
  <Guid i:nil="true" />
  <IsAttachments>false</IsAttachments>
  <ProjectGuid i:nil="true" />
  <ProjectId>0</ProjectId>
  <Tags i:nil="true" />
  <ActualEffort i:nil="true" />
  <CompletionPercent>0</CompletionPercent>
  <ComponentId i:nil="true" />
  <CreationDate>0001-01-01T00:00:00</CreationDate>
  <CreatorGuid i:nil="true" />
  <CreatorId i:nil="true" />
  <Description i:nil="true" />
  <EndDate i:nil="true" />
  <EstimatedEffort i:nil="true" />
  <LastUpdateDate>0001-01-01T00:00:00</LastUpdateDate>
  <Name i:nil="true" />
  <OwnerGuid i:nil="true" />
  <OwnerId i:nil="true" />
  <OwnerName i:nil="true" />
  <ProjectName i:nil="true" />
  <ProjectedEffort i:nil="true" />
  <ReleaseGuid i:nil="true" />
  <ReleaseId i:nil="true" />
  <ReleaseVersionNumber i:nil="true" />
  <RemainingEffort i:nil="true" />
  <RequirementId i:nil="true" />
  <RequirementName i:nil="true" />
  <RiskId i:nil="true" />
  <StartDate i:nil="true" />
  <TaskFolderId i:nil="true" />
  <TaskId i:nil="true" />
  <TaskPriorityId i:nil="true" />
  <TaskPriorityName i:nil="true" />
  <TaskStatusId>0</TaskStatusId>
  <TaskStatusName i:nil="true" />
  <TaskTypeId i:nil="true" />
  <TaskTypeName i:nil="true" />
  <DestBranchId i:nil="true" />
  <DestBranchName i:nil="true" />
  <SourceBranchId i:nil="true" />
  <SourceBranchName i:nil="true" />
</RemotePullRequest>

{"SourceBranchId":null,
"SourceBranchName":null,
"DestBranchId":null,
"DestBranchName":null,
"TaskId":null,
"TaskStatusId":0,
"TaskTypeId":null,
"TaskFolderId":null,
"RequirementId":null,
"ReleaseId":null,
"ReleaseGuid":null,
"ComponentId":null,
"CreatorId":null,
"OwnerId":null,
"CreatorGuid":null,
"OwnerGuid":null,
"TaskPriorityId":null,
"Name":null,
"Description":null,
"CreationDate":"0001-01-01T00:00:00",
"LastUpdateDate":"0001-01-01T00:00:00",
"StartDate":null,
"EndDate":null,
"CompletionPercent":0,
"EstimatedEffort":null,
"ActualEffort":null,
"RemainingEffort":null,
"ProjectedEffort":null,
"TaskStatusName":null,
"TaskTypeName":null,
"OwnerName":null,
"TaskPriorityName":null,
"ProjectName":null,
"ReleaseVersionNumber":null,
"RequirementName":null,
"RiskId":null,
"ProjectId":0,
"ProjectGuid":null,
"ArtifactTypeId":0,
"ConcurrencyDate":"0001-01-01T00:00:00",
"CustomProperties":null,
"IsAttachments":false,
"Tags":null,
"Guid":null}