# List

`GET /workspaces/:workspace/projects/:project_name/pipelines/:pipeline_id/executions`

Returns list of executions for the specified pipeline

**Required Scopes:** `PIPELINE_READ`

## URL Parameters

```typescript
interface URLParameters {
  /** The human-readable ID of the workspace */
  workspace: string; // Example: "my-company"
  /** The human-readable ID of the project */
  project_name: string; // Example: "my-project"
  /** The ID of the pipeline */
  pipeline_id: number; // Example: 123
}
```

## Query Parameters

```typescript
interface QueryParameters {
  /** The number of the successive pages (results are split into pages of per_page elements each). */
  page?: number; // Example: 1
  /** Specifies the number of returned elements on the page. The default value is 20. */
  per_page?: number; // Example: 20
}
```

## Response Body

```typescript
interface ResponseBody {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The current page number */
  page?: number;
  /** The number of elements per page */
  page_size?: number;
  /** The total number of pages */
  total_page_count?: number;
  /** The number of elements on the current page */
  element_count?: number;
  /** The total number of elements across all pages */
  total_element_count?: number;
  executions?: ShortExecutionView[];
}
```

## Type Definitions

```typescript
interface ShortExecutionView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The unique ID of the execution */
  id?: number;
  /** The date and time when the execution started */
  start_date?: string;
  /** The date and time when the execution finished */
  finish_date?: string;
  /** The mode that triggered the execution */
  triggered_on?: "CLICK" | "SCHEDULE" | "EVENT" | "PIPELINE" | "WEBHOOK" | "EMAIL";
  /** The priority of the execution. Default is NORMAL */
  priority?: "LOW" | "NORMAL" | "HIGH";
  /** The date when the execution should be run. Should be set in the format: 2026-11-18T12:38:16.000Z */
  delay_until?: string;
  /** Deploy from scratch */
  refresh?: boolean;
  /** Clear cache before running the pipeline */
  clear_cache?: boolean;
  /** The current status of the execution */
  status?: "INPROGRESS" | "ENQUEUED" | "TERMINATED" | "SUCCESSFUL" | "FAILED" | "INITIAL" | "NOT_EXECUTED" | "SKIPPED" | "TERMINATING" | "WAITING_FOR_APPLY" | "WAITING_FOR_VARIABLES" | "WAITING_FOR_SETTABLE_VARIABLES" | "WAITING_FOR_VT_SESSION";
  /** The comment or description provided for this execution */
  comment?: string;
  branch?: BranchView;
  tag?: TagView;
  pull_request?: PullRequestView;
  /** The commit containing the revision field */
  from_revision?: ShortCommitView;
  /** The commit containing the revision field */
  to_revision?: ShortCommitView;
  /** User/member reference */
  creator?: MemberView;
  environment?: ShortEnvironmentView;
  /** Short representation of a artifact version for list views */
  artifact_version?: ShortArtifactVersionView;
  /** The loop details of the execution, if the pipeline was executed in a loop */
  loop_details?: ExecutionLoopDetailsView;
  /** Short representation of a artifact object */
  artifact?: ShortArtifactView;
}

interface BranchView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The name of the branch */
  name?: string;
  /** The commit containing the revision field */
  commit?: ShortCommitView;
  /** The description of the branch */
  description?: string;
  /** Access permissions configuration */
  permissions?: PermissionsView;
  /** Indicates whether this branch is default branch in the repository */
  default?: boolean;
}

interface ShortCommitView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The full SHA hash of the commit */
  revision?: string;
  /** The date when the commit was authored */
  author_date?: string;
  /** The date when the commit was committed */
  commit_date?: string;
  /** The short SHA hash of the commit (first 7 characters) */
  short_revision?: string;
  /** The commit message */
  message?: string;
  /** User/member reference */
  committer?: MemberView;
  /** User/member reference */
  author?: MemberView;
}

interface MemberView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The ID of the user */
  id?: number;
  /** The name of the user */
  name?: string;
  /** The unique username of the user */
  username?: string;
  /** The avatar URL of the user */
  avatar_url?: string;
  /** The email address of the user */
  email?: string;
  /** Whether the user has admin privileges */
  admin?: boolean;
  /** Whether the user is workspace owner */
  workspace_owner?: boolean;
}

interface PermissionsView {
  /** Access level for other workspace members */
  others?: "DENIED" | "READ_ONLY" | "USE_ONLY" | "BLIND" | "RUN_ONLY" | "READ_WRITE" | "MANAGE" | "DEFAULT" | "ALLOWED" | "STAGE" | "COMMIT";
  /** List of specific users with their access levels */
  users?: UserPermissionView[];
  /** List of user groups with their access levels */
  groups?: GroupPermissionView[];
}

interface UserPermissionView {
  /** The ID of the user */
  id?: number;
  /** The access level for the user */
  access_level?: "DENIED" | "READ_ONLY" | "USE_ONLY" | "BLIND" | "RUN_ONLY" | "READ_WRITE" | "MANAGE" | "DEFAULT" | "ALLOWED" | "STAGE" | "COMMIT";
}

interface GroupPermissionView {
  /** The ID of the group */
  id?: number;
  /** The access level for the group */
  access_level?: "DENIED" | "READ_ONLY" | "USE_ONLY" | "BLIND" | "RUN_ONLY" | "READ_WRITE" | "MANAGE" | "DEFAULT" | "ALLOWED" | "STAGE" | "COMMIT";
}

interface TagView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The name of the tag */
  name?: string;
  /** The commit containing the revision field */
  commit: ShortCommitView;
  /** The tag message (for annotated tags) */
  message?: string;
}

interface PullRequestView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The pull request reference name (e.g., 'pull/5') */
  name?: string;
  /** The pull request number */
  number?: number;
  /** The HTML URL to the pull request on GitHub */
  github_html_url?: string;
  /** The state of the pull request (OPEN, CLOSED, MERGED) */
  state?: string;
  /** The title of the pull request */
  title?: string;
  /** The description of the pull request */
  description?: string;
  /** The name of the base branch (the branch the changes are merged into) */
  base?: string;
  /** The name of the head branch (the branch containing the changes) */
  head?: string;
  /** The revision of the last commit on the head branch */
  head_sha?: string;
  /** Indicates whether the pull request is a draft */
  draft?: boolean;
  /** Indicates whether the head branch can be merged into the base branch without conflicts (MERGEABLE, CONFLICTING, UNKNOWN) */
  mergeable?: string;
  /** The number of commits on the head branch that are not on the base branch; empty when unknown */
  ahead?: number;
  /** The number of commits on the base branch that are not on the head branch; empty when unknown */
  behind?: number;
  /** The date when the pull request was created */
  create_date?: string;
  /** The date when the pull request was last updated */
  last_update_date?: string;
  /** The date when the pull request was merged */
  merged_date?: string;
  /** The date when the pull request was closed */
  closed_date?: string;
  /** The labels assigned to the pull request */
  labels?: string[];
  /** The logins of the users assigned to the pull request */
  assignees?: string[];
  /** The logins of the users requested to review the pull request */
  reviewers?: string[];
  /** The provider of the pull request: BUDDY for pull requests in repositories hosted in Buddy, otherwise the integrated Git provider */
  origin?: "BUDDY" | "GITHUB" | "GITHUB_ENTERPRISE" | "GITLAB" | "GITLAB_ENTERPRISE" | "BITBUCKET" | "CUSTOM";
}

interface ShortEnvironmentView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The ID of the environment */
  id?: string;
  /** The name of the environment */
  name?: string;
  /** A human-readable ID of the environment. Alphanumeric characters, underscores, and hyphens (hyphens cannot appear at the start or end). */
  identifier?: string;
  /** The list of tags associated with the environment */
  tags?: string[];
  /** The scope of the environment */
  scope?: "PROJECT" | "WORKSPACE";
}

interface ShortArtifactVersionView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The unique ID of the version (used in API endpoints) */
  id?: string;
  /** The version identifier (e.g., latest, v1.2.0, stable) */
  version?: string;
  /** Size of the version content in bytes */
  size?: number;
  /** Whether the GitHub release synced into this version is a draft. Present only for GH_RELEASE artifacts */
  draft?: boolean;
  /** Whether the GitHub release synced into this version is a pre-release. Present only for GH_RELEASE artifacts */
  prerelease?: boolean;
  /** Direct URL to access the artifact version content. For CONTAINER artifacts, this is the registry URL (e.g., container.registry.sh/ttests/ubuntu:latest). For FILES artifacts, this is the HTTP server URL where the content is served (e.g., https://latest-my-artifact.bucket-1.registry.sh/) */
  version_url?: string;
  /** Version creation timestamp */
  created_date?: string;
}

interface ExecutionLoopDetailsView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The status of the execution loop resolution */
  status?: "OK" | "DYNAMIC" | "ERROR";
  /** The resolved execution loop variables as key-value pairs */
  resolved_variables?: SimpleVariableView[];
  /** The error message if the execution loop resolution failed */
  error_message?: string;
}

interface SimpleVariableView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The name of the variable */
  key?: string;
  /** The value of the variable */
  value?: string;
  /** If set to `true` the variable value will be encrypted and hidden */
  encrypted?: boolean;
}

interface ShortArtifactView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The unique ID of the artifact */
  id?: string;
  /** The type of artifact */
  type?: "CONTAINER" | "BUCKET" | "NPM" | "COMPOSER";
  /** The subtype of the artifact. GH_RELEASE artifacts have their versions synced from GitHub releases. Only GH_RELEASE can be set on create */
  subtype?: "STORYBOOK" | "GH_RELEASE";
  /** The display name of the artifact */
  name?: string;
  /** The human-readable identifier of the artifact */
  identifier?: string;
  /** The scope level of the artifact */
  scope?: "WORKSPACE" | "PROJECT" | "ENVIRONMENT";
  /** Total size of all artifact versions in bytes */
  size?: number;
}

```

## Response Example

**Status:** `200 OK`

```json
{
  "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/pipelines/2/executions",
  "html_url": "https://app.buddy.works/my-workspace/my-project/pipelines/pipeline/2/executions",
  "page": 1,
  "page_size": 20,
  "total_page_count": 1,
  "element_count": 2,
  "total_element_count": 2,
  "executions": [
    {
      "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/pipelines/2/executions/2",
      "html_url": "https://app.buddy.works/my-workspace/my-project/pipelines/pipeline/2/execution/68e60c55592ab1f894ecace6",
      "id": 2,
      "start_date": "2025-10-08T07:01:42.029Z",
      "finish_date": "2025-10-08T07:01:45.886Z",
      "triggered_on": "EVENT",
      "priority": "NORMAL",
      "refresh": true,
      "clear_cache": true,
      "status": "SUCCESSFUL",
      "comment": "test",
      "branch": {
        "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/repository/branches/dev-issue1",
        "html_url": "https://app.buddy.works/my-workspace/my-project/repository/branch/dev-issue1",
        "name": "dev-issue1",
        "default": false
      },
      "to_revision": {
        "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/repository/commits/90d11b5b54108fa57b30ae286322b99b26d46ccb",
        "html_url": "https://app.buddy.works/my-workspace/my-project/repository/commit/90d11b5b54108fa57b30ae286322b99b26d46ccb",
        "revision": "90d11b5b54108fa57b30ae286322b99b26d46ccb",
        "author_date": "2025-10-08T06:22:11Z",
        "commit_date": "2025-10-08T06:22:11Z",
        "message": "Added sad",
        "committer": {
          "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
          "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
          "id": 1,
          "name": "Mike",
          "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1759904496204",
          "email": "mike@company.com",
          "admin": true,
          "workspace_owner": true
        },
        "author": {
          "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
          "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
          "id": 1,
          "name": "Mike",
          "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1759904496204",
          "email": "mike@company.com",
          "admin": true,
          "workspace_owner": true
        }
      },
      "creator": {
        "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
        "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
        "id": 1,
        "name": "Mike",
        "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1759904496204",
        "email": "mike@company.com",
        "admin": true,
        "workspace_owner": true
      },
      "environment": {
        "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/environments/nZrnl40Y",
        "html_url": "https://app.buddy.works/my-workspace/my-project/environments/environment/nZrnl40Y",
        "name": "staging",
        "identifier": "my-staging",
        "id": "nZrnl40Y",
        "scope": "PROJECT"
      },
      "artifact": {
        "url": "https://api.buddy.works/workspaces/my-workspace/artifacts/x5169jL2",
        "html_url": "https://app.buddy.works/my-workspace/-/artifacts/x5169jL2/versions",
        "id": "x5169jL2",
        "type": "CONTAINER",
        "name": "My Application Artifact",
        "identifier": "my-app-artifact",
        "scope": "WORKSPACE",
        "size": 1048576000
      },
      "artifact_version": {
        "url": "https://api.buddy.works/workspaces/my-workspace/artifacts/x5169jL2/versions/0YgEzRGv",
        "html_url": "https://app.buddy.works/my-workspace/-/artifacts/x5169jL2/versions/0YgEzRGv",
        "version_url": "https://latest-my-artifact.bucket-1.registry.sh/",
        "id": "0YgEzRGv",
        "version": "latest",
        "size": 1048576,
        "created_date": "2024-01-20T10:30:00Z"
      }
    },
    {
      "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/pipelines/2/executions/1",
      "html_url": "https://app.buddy.works/my-workspace/my-project/pipelines/pipeline/2/execution/68e60c20592ab1f894ecacd4",
      "id": 1,
      "start_date": "2025-10-08T07:00:48.912Z",
      "finish_date": "2025-10-08T07:00:54.148Z",
      "triggered_on": "CLICK",
      "priority": "NORMAL",
      "refresh": true,
      "clear_cache": true,
      "status": "SUCCESSFUL",
      "comment": "test",
      "branch": {
        "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/repository/branches/master",
        "html_url": "https://app.buddy.works/my-workspace/my-project/repository/branch/master",
        "name": "master",
        "default": true
      },
      "to_revision": {
        "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/repository/commits/90d11b5b54108fa57b30ae286322b99b26d46ccb",
        "html_url": "https://app.buddy.works/my-workspace/my-project/repository/commit/90d11b5b54108fa57b30ae286322b99b26d46ccb",
        "revision": "90d11b5b54108fa57b30ae286322b99b26d46ccb",
        "author_date": "2025-10-08T06:22:11Z",
        "commit_date": "2025-10-08T06:22:11Z",
        "message": "Added sad",
        "committer": {
          "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
          "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
          "id": 1,
          "name": "Mike",
          "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1759904496204",
          "email": "mike@company.com",
          "admin": true,
          "workspace_owner": true
        },
        "author": {
          "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
          "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
          "id": 1,
          "name": "Mike",
          "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1759904496204",
          "email": "mike@company.com",
          "admin": true,
          "workspace_owner": true
        }
      },
      "creator": {
        "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
        "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
        "id": 1,
        "name": "Mike",
        "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1759904496204",
        "email": "mike@company.com",
        "admin": true,
        "workspace_owner": true
      }
    }
  ]
}
```

---
Original source: https://buddy.works/docs/api/executions/list