<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/pull-requests",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Pull Requests"
}
-->

# Pull Requests

Read pull request information such as source and destination branches.

## Discussion

The `scmPullRequests` resource represents pull requests (PRs) for repositories Xcode Cloud can access. Use it to access:

- A PR’s number, URL, title, and status
- The destination and source branches
- A value that indicates whether the PR involves more than one repository

> Note:
> This resource supports JSON web tokens with a lifetime of up to six months. For more information, see <doc://com.apple.appstoreconnectapi/documentation/AppStoreConnectAPI/generating-tokens-for-api-requests#Determine-the-Appropriate-Token-Lifetime>.

## Topics

### Getting Pull Request Information

[`Read pull request information`](/documentation/AppStoreConnectAPI/GET-v1-scmPullRequests-_id_)

Get information about a specific pull request.

### Objects

[`object ScmPullRequest`](/documentation/AppStoreConnectAPI/ScmPullRequest)

A pull request in a source code repository connected to Xcode Cloud, which can automatically trigger workflow builds.

[`object ScmPullRequestResponse`](/documentation/AppStoreConnectAPI/ScmPullRequestResponse)

The response body for endpoints that read a single SCM pull request linked to Xcode Cloud.

[`object ScmPullRequestsResponse`](/documentation/AppStoreConnectAPI/ScmPullRequestsResponse)

The response body for endpoints that list SCM pull requests linked to Xcode Cloud.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)