--- title: list-invocations-for-a-team-optionally-filtered-by-repository-and-invocation-metadata product: vercel url: /docs/rest-api/vercel-ci/list-invocations-for-a-team-optionally-filtered-by-repository-and-invocation-metadata canonical_url: "https://vercel.com/docs/rest-api/vercel-ci/list-invocations-for-a-team-optionally-filtered-by-repository-and-invocation-metadata" last_updated: 2026-09-25 type: reference prerequisites: [] related: - /docs/rest-api summary: Learn about list-invocations-for-a-team-optionally-filtered-by-repository-and-invocation-metadata on Vercel. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # List invocations for a team, optionally filtered by repository and invocation metadata ```http GET /v2/vercel-ci/invocations ``` List Invocations ## Authentication **bearerToken**: HTTP bearer ## Query parameters | Name | Type | Required | Description | |---|---|---|---| | `provider` | string. enum: github, gitlab, bitbucket, vercel | No | Repository provider (e.g., \"github\"). | | `repository` | string | No | Repository slug (e.g., \"vercel/next.js\"). | | `branchName` | string | No | Branch name (e.g., \"main\"). | | `snapshot` | string | No | Snapshot/commit hash. | | `status` | array | No | | | `conclusion` | array | No | | | `source` | array | No | | | `authorGitHubId` | string | No | | | `author` | string | No | GitHub author login. | | `createdAfter` | number | No | | | `createdBefore` | number | No | | | `limit` | number | No | Number of results per page (default: 20, max: 100). | | `cursor` | string | No | Pagination cursor from a previous response. | | `teamId` | string | No | The Team identifier to perform the request on behalf of. | | `slug` | string | No | The Team slug to perform the request on behalf of. | ## Example request ### TypeScript ```typescript const response = await fetch('https://api.vercel.com/v2/vercel-ci/invocations?provider=string&repository=string&branchName=string&snapshot=string&status=[]&conclusion=[]&source=[]&authorGitHubId=string&author=string&createdAfter=123&createdBefore=123&limit=123&cursor=string&teamId=string&slug=string', { method: 'GET', headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'Content-Type': 'application/json', }, }); const data = await response.json(); console.log(data); ``` ### Next.js ```typescript 'use server'; export async function callEndpoint() { const response = await fetch('https://api.vercel.com/v2/vercel-ci/invocations?provider=string&repository=string&branchName=string&snapshot=string&status=[]&conclusion=[]&source=[]&authorGitHubId=string&author=string&createdAfter=123&createdBefore=123&limit=123&cursor=string&teamId=string&slug=string', { method: 'GET', headers: { 'Authorization': `Bearer ${process.env.VERCEL_ACCESS_TOKEN}`, 'Content-Type': 'application/json', }, next: { revalidate: 3600 } }); if (!response.ok) { throw new Error('Request failed'); } return response.json(); } ``` ### cURL ```bash curl -X GET 'https://api.vercel.com/v2/vercel-ci/invocations?provider=string&repository=string&branchName=string&snapshot=string&status=[]&conclusion=[]&source=[]&authorGitHubId=string&author=string&createdAfter=123&createdBefore=123&limit=123&cursor=string&teamId=string&slug=string' \ -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ -H 'Content-Type: application/json' ``` ## Example response ```json { "invocations": [ { "invocationId": "example_id", "attempt": "123", "teamId": "example_id", "source": { "type": "string" }, "createdAt": "123", "repositoryKey": "string", "ref": "string", "commitSha": "string", "skipped": { "reason": "Customer requested refund" }, "bootstrappingStarted": { "startedAt": "123" }, "bootstrappingFailed": { "reason": "Customer requested refund" }, "sandboxSnapshotted": { "sandboxSnapshotId": "example_id", "workingDirectory": "string", "snapshottedAt": "123" }, "sandboxNamed": { "sandboxName": "Example Name", "workingDirectory": "string", "readyAt": "123" }, "jobDefinitionsCreated": { "names": [], "source": "string", "scheduledAt": "123" }, "completed": { "completedAt": "123", "conclusion": "string" }, "setupConclusion": { "result": "string" }, "runConclusion": { "result": "string" }, "status": "string" } ], "repositories": "value", "pagination": { "nextCursor": "string" } } ``` ## Responses ### 200: Successfully listed invocations. Content-Type: `application/json` ```json { "type": "object", "required": [ "invocations", "repositories", "pagination" ], "properties": { "invocations": { "type": "array", "items": { "type": "object", "required": [ "invocationId", "attempt", "teamId", "source", "createdAt", "repositoryKey", "ref", "commitSha", "status" ], "properties": { "invocationId": { "type": "string" }, "attempt": { "type": "number" }, "teamId": { "type": "string" }, "source": {}, "createdAt": { "type": "number" }, "repositoryKey": { "type": "string" }, "ref": { "type": "string" }, "commitSha": { "type": "string" }, "skipped": { "type": "object", "required": [ "reason" ] }, "bootstrappingStarted": { "type": "object", "required": [ "startedAt" ] }, "bootstrappingFailed": { "type": "object", "required": [ "reason" ] }, "sandboxSnapshotted": { "type": "object", "required": [ "sandboxSnapshotId", "workingDirectory" ] }, "sandboxNamed": { "type": "object", "required": [ "sandboxName", "workingDirectory" ] }, "jobDefinitionsCreated": { "type": "object", "required": [ "names" ] }, "completed": { "type": "object", "required": [ "completedAt" ] }, "setupConclusion": { "type": "object", "description": "The terminal setup result. Omitted while invocation setup is still running.", "required": [ "result" ] }, "runConclusion": { "type": "object", "description": "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.", "required": [ "result" ] }, "status": {} } } }, "repositories": { "type": "object" }, "pagination": { "type": "object", "properties": { "nextCursor": { "type": "string" } } } } } ``` ### 400: One of the provided values in the request query is invalid. ### 401: The request is not authorized. Content-Type: `application/json` ```json { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } ``` ### 403: You do not have permission to access this resource. Content-Type: `application/json` ```json { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } ``` ### 410: No description ### 429: No description Content-Type: `application/json` ```json { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "name", "message", "limit" ], "properties": { "code": { "type": "string" }, "name": { "type": "string" }, "message": { "type": "string" }, "limit": { "type": "number" } } } } } ``` ### 500: No description Content-Type: `application/json` ```json { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } ``` ### 503: No description --- ## Related - [vercel-ci endpoints](/docs/rest-api#vercel-ci) - [REST API overview](/docs/rest-api) - [OpenAPI spec](https://vercel.com/openapi.json) (machine-readable, all endpoints) --- [View full sitemap](/docs/sitemap)