---
title: "List invocations for a team, optionally filtered by repository and invocation metadata"
method: GET
path: "/v2/vercel-ci/invocations"
tags: ["vercel-ci"]
---

# List invocations for a team, optionally filtered by repository and invocation metadata

`GET /v2/vercel-ci/invocations`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v2/vercel-ci/invocations`
- Auth: HTTP bearer

List Invocations

## Query parameters

- `provider` 'github' | 'gitlab' | 'bitbucket' | 'vercel': Repository provider (e.g., \"github\").
- `repository` string: Repository slug (e.g., \"vercel/next.js\").
- `branchName` string: Branch name (e.g., \"main\").
- `snapshot` string: Snapshot/commit hash.
- `status` string[]
- `conclusion` string[]
- `source` string[]
- `authorGitHubId` string
- `author` string: GitHub author login.
- `createdAfter` number
- `createdBefore` number
- `limit` number: Number of results per page (default: 20, max: 100).
- `cursor` string: Pagination cursor from a previous response.
- `teamId` string
- `slug` string

## Response `200`

Successfully listed invocations.

- object
  - `invocations` object[], required
    - `invocationId` string, required
    - `attempt` number, required
    - `teamId` string, required
    - `source` union, required
      - object
        - `type` string, required
      - object
        - `type` string, required
        - `deploymentId` string, required
        - `projectId` string, required
        - `deploymentTargetSlug` string, required
    - `createdAt` number, required
    - `repositoryKey` string, required
    - `ref` string, required
    - `commitSha` string, required
    - `skipped` object
      - `reason` string, required
    - `bootstrappingStarted` object
      - `startedAt` number, required
    - `bootstrappingFailed` object
      - `reason` string, required
    - `sandboxSnapshotted` object
      - `sandboxSnapshotId` string, required
      - `workingDirectory` string, required
      - `snapshottedAt` number
    - `sandboxNamed` object
      - `sandboxName` string, required
      - `workingDirectory` string, required
      - `readyAt` number
    - `jobDefinitionsCreated` object
      - `names` string[], required
      - `source` union
        - string
        - string
        - string
      - `scheduledAt` number
    - `completed` object
      - `completedAt` number, required
      - `conclusion` union
        - string
        - string
        - string
    - `setupConclusion` object: The terminal setup result. Omitted while invocation setup is still running.
      - `result` union, required
        - string
        - string
        - string
    - `runConclusion` object: The aggregate outcome of every job in the invocation. Omitted while jobs are still running. Any failed job → "failed"; any (non-cascade) skipped job → "skipped"; else "succeeded". Present on completed invocations written after the field shipped; absent on older rows.
      - `result` union, required
        - string
        - string
        - string
    - `status` union, required
      - string
      - string
      - string
      - string
      - string
      - string
      - string
      - string
      - string
      - string
      - string
      - string
  - `repositories` object, required
  - `pagination` object, required
    - `nextCursor` string

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`
- `429`
- `500`
- `503`

## Changes

- **2026-09-30** `099fbe1f521c`: 1 info
  - added the non-success response with the status `404`
- **2026-09-25** `7881412aa042`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/api/changes/v2/vercel-ci/invocations/get.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) - [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/api/revisions/4a06e85c2848?raw)