> ## Documentation Index > Fetch the complete documentation index at: https://lightdash-06-24-docs-simplify-date-zoom-usage-description.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List pull requests > List the pull requests that have been created by write-backs for a project ## OpenAPI ````yaml https://raw.githubusercontent.com/lightdash/lightdash/refs/heads/main/packages/backend/src/generated/swagger.json get /api/v1/projects/{projectUuid}/pull-requests openapi: 3.0.0 info: title: Lightdash API version: 0.3228.0 description: > Open API documentation for all public Lightdash API endpoints. # Authentication Before you get started, you might need to create a Personal Access Token to authenticate via the API. You can create a token by following this guide: https://docs.lightdash.com/references/personal_tokens license: name: MIT contact: name: Lightdash Support email: support@lightdash.com url: https://docs.lightdash.com/help-and-contact/contact/contact_info/ servers: - url: / security: [] tags: - name: My Account description: These routes allow users to manage their own user account. - name: Organizations description: >- Each user is a member of a single organization. These routes allow users to manage their organization. Most actions are only available to admin users. - name: Projects description: >- Projects belong to a single organization. These routes allow users to manage their projects, browse content, and execute queries. Users inside an organization might have access to a project from an organization-level role or they might be granted access to a project directly. - name: Spaces description: >- Spaces allow you to organize charts and dashboards within a project. They also allow granular access to content by allowing you to create private spaces, which are only accessible to the creator and admins. - name: Roles & Permissions description: >- These routes allow users to manage roles and permissions for their organization. externalDocs: url: https://docs.lightdash.com/references/roles - name: Query description: >- These routes allow users to execute and manage queries against their data warehouse. This includes metric queries, SQL queries, and retrieving query results. paths: /api/v1/projects/{projectUuid}/pull-requests: get: tags: - Pull Requests summary: List pull requests description: >- List the pull requests that have been created by write-backs for a project operationId: listPullRequests parameters: - in: path name: projectUuid required: true schema: type: string - in: query name: page required: false schema: type: number format: double - in: query name: pageSize required: false schema: type: number format: double responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ApiPullRequestsResponse' default: description: Error content: application/json: schema: $ref: '#/components/schemas/ApiErrorPayload' security: [] components: schemas: ApiPullRequestsResponse: properties: results: $ref: '#/components/schemas/KnexPaginatedData_PullRequestWithStatus-Array_' status: type: string enum: - ok nullable: false required: - results - status type: object ApiErrorPayload: properties: error: properties: data: $ref: '#/components/schemas/AnyType' description: Optional data containing details of the error message: type: string description: A friendly message summarising the error name: type: string description: Unique name for the type of error statusCode: type: number format: integer description: HTTP status code required: - name - statusCode type: object status: type: string enum: - error nullable: false required: - error - status type: object description: |- The Error object is returned from the api any time there is an error. The message contains KnexPaginatedData_PullRequestWithStatus-Array_: properties: pagination: allOf: - $ref: '#/components/schemas/KnexPaginateArgs' - properties: totalResults: type: number format: double totalPageCount: type: number format: double required: - totalResults - totalPageCount type: object data: items: $ref: '#/components/schemas/PullRequestWithStatus' type: array required: - data type: object AnyType: description: |- This AnyType is an alias for any The goal is to make it easier to identify any type in the codebase without having to eslint-disable all the time These are only used on legacy `any` types, don't use it for new types. This is added on a separate file to avoid circular dependencies. KnexPaginateArgs: properties: page: type: number format: double pageSize: type: number format: double required: - page - pageSize type: object PullRequestWithStatus: allOf: - $ref: '#/components/schemas/PullRequest' - properties: state: allOf: - $ref: '#/components/schemas/PullRequestState' nullable: true title: type: string nullable: true required: - state - title type: object description: >- A stored pull request enriched with its live title/state resolved from the provider API. `title`/`state` are null when the live lookup fails (e.g. the PR was deleted or the token lost access) — `prUrl` always remains usable. PullRequest: properties: createdAt: type: string format: date-time reviewContext: allOf: - $ref: '#/components/schemas/PullRequestReviewContext' nullable: true description: >- Source review context for AI review remediation PRs. Present when the PR was opened to address a review finding. aiAgentUuid: type: string nullable: true description: >- The AI agent that owns the thread above. Paired with `aiThreadUuid` to build the in-app thread link. Null whenever `aiThreadUuid` is null. aiThreadUuid: type: string nullable: true description: >- The AI thread that produced this PR, when it originated from an AI write-back (source `ai_agent`). Null for non-AI PRs, or in deployments without the enterprise AI write-back feature. summary: type: string nullable: true description: >- Two-line user-facing "what this PR does", written by the AI write-back agent at PR creation. Null for non-AI PRs and PRs predating the field — consumers fall back to the live PR title. prUrl: type: string prNumber: type: number format: double repo: type: string owner: type: string source: $ref: '#/components/schemas/PullRequestSource' provider: $ref: '#/components/schemas/PullRequestProvider' createdByUserUuid: type: string nullable: true projectUuid: type: string organizationUuid: type: string pullRequestUuid: type: string required: - createdAt - reviewContext - aiAgentUuid - aiThreadUuid - summary - prUrl - prNumber - repo - owner - source - provider - createdByUserUuid - projectUuid - organizationUuid - pullRequestUuid type: object description: |- A pull request created by a write-back. Only immutable identifiers are persisted; the live title/state are resolved at runtime from the GitHub/GitLab API using provider + owner + repo + prNumber. PullRequestState: enum: - open - closed - merged type: string PullRequestReviewContext: properties: sourceAgentUuid: type: string sourceProjectUuid: type: string sourceThreadUuid: type: string sourceFindingUuid: type: string primaryRootCause: $ref: '#/components/schemas/AiAgentRootCause' reviewStatus: $ref: '#/components/schemas/AiAgentReviewItemStatus' reviewTitle: type: string reviewItemFingerprint: type: string reviewItemUuid: type: string required: - sourceAgentUuid - sourceProjectUuid - sourceThreadUuid - sourceFindingUuid - primaryRootCause - reviewStatus - reviewTitle - reviewItemFingerprint - reviewItemUuid type: object PullRequestSource: enum: - custom_metric - custom_dimension - sql_runner - source_editor - ai_agent type: string PullRequestProvider: enum: - github - gitlab type: string AiAgentRootCause: type: string enum: - semantic_layer - project_context - agent_configuration - product_capability - runtime_reliability - feedback_quality - not_a_failure - ambiguous AiAgentReviewItemStatus: type: string enum: - triage - open - in_progress - resolved - dismissed - duplicate ````