> ## Documentation Index > Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # List run groups > List completed run groups with filters and pagination. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/run-groups openapi: 3.0.3 info: title: Momentic Analytics API version: 1.0.0 description: Read completed runs and run groups from Momentic analytics. servers: - url: https://api.momentic.ai security: - bearerAuth: [] tags: - name: Analytics paths: /v1/run-groups: get: tags: - Analytics summary: List run groups description: List completed run groups with filters and pagination. operationId: listRunGroups parameters: - name: pageSize in: query required: false description: Page size, up to 100. schema: type: integer default: 20 minimum: 1 maximum: 100 - name: cursor in: query required: false description: >- Opaque keyset cursor from a previous response's pagination.nextCursor. Omit for the first page. schema: type: string - name: includeTotal in: query required: false description: >- Include the exact total match count in the response. Off by default to avoid an extra aggregation. Accepts true, false, 1, or 0. schema: type: boolean - name: startDate in: query required: false description: >- Start of the window. Defaults to the last 30 days. Window may not exceed 92 days. schema: type: string format: date-time - name: endDate in: query required: false description: End of the window. Defaults to now. schema: type: string format: date-time - name: status in: query required: false style: form explode: false description: Completed run group statuses. Comma-separated. schema: type: array items: type: string enum: - PASSED - FAILED - CANCELLED - name: trigger in: query required: false style: form explode: false description: Run trigger values. Comma-separated. schema: type: array items: type: string enum: - WEBHOOK - CRON - MANUAL - CLI - name: gitBranchName in: query required: false style: form explode: false description: Git branch name filter. Comma-separated. schema: type: array items: type: string - name: githubRepository in: query required: false style: form explode: false description: GitHub repository filter. Comma-separated. schema: type: array items: type: string - name: gitlabProjectPath in: query required: false style: form explode: false description: GitLab project path filter. Comma-separated. schema: type: array items: type: string - name: gitCommitSha in: query required: false description: Exact commit SHA filter. schema: type: string - name: cliVersion in: query required: false style: form explode: false description: CLI version filter. Comma-separated. schema: type: array items: type: string - name: label in: query required: false style: form explode: false description: Labels attached to the run group. Comma-separated. schema: type: array items: type: string - name: executionType in: query required: false style: form explode: false description: Run platform filter. Comma-separated. schema: type: array items: type: string enum: - WEB - IOS - ANDROID responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/ExternalRunGroupsResponse' example: data: - id: run_group_01J9D90XPXMA4T0TSN76VFQ2K8 status: FAILED trigger: WEBHOOK createdAt: '2026-07-01T12:00:00.000Z' startedAt: '2026-07-01T12:00:10.000Z' finishedAt: '2026-07-01T12:05:14.000Z' gitBranchName: main gitCommitSha: 8d8b7f5c0c2d5d2a0c8c4d6b9a1a2b3c4d5e6f70 gitCommitShaShort: 8d8b7f5 githubRepository: momentic-ai/storefront gitlabProjectPath: null pipelineId: build_1827 ciProvider: github cliVersion: 1.24.0 suite: id: suite_checkout name: Checkout localSuiteName: null labels: - smoke - checkout runCounts: total: 4 passed: 3 failed: 1 cancelled: 0 pagination: pageSize: 20 hasMore: false nextCursor: null total: null '400': description: Error. content: application/json: schema: type: object properties: error: type: string required: - error additionalProperties: false example: error: 'Invalid query: pageSize must be less than or equal to 100' '401': description: Error. content: application/json: schema: type: object properties: error: type: string required: - error additionalProperties: false example: error: 'Invalid query: pageSize must be less than or equal to 100' components: schemas: ExternalRunGroupsResponse: type: object properties: data: type: array items: type: object properties: id: type: string status: type: string enum: - PASSED - FAILED - CANCELLED trigger: type: string enum: - WEBHOOK - CRON - MANUAL - CLI createdAt: type: string format: date-time startedAt: type: string format: date-time finishedAt: type: string format: date-time gitBranchName: nullable: true type: string gitCommitSha: nullable: true type: string gitCommitShaShort: nullable: true type: string githubRepository: nullable: true type: string gitlabProjectPath: nullable: true type: string pipelineId: nullable: true type: string ciProvider: nullable: true type: string cliVersion: nullable: true type: string suite: nullable: true type: object properties: id: type: string name: type: string required: - id - name additionalProperties: false localSuiteName: nullable: true type: string labels: type: array items: type: string runCounts: type: object properties: total: type: integer minimum: 0 maximum: 9007199254740991 passed: type: integer minimum: 0 maximum: 9007199254740991 failed: type: integer minimum: 0 maximum: 9007199254740991 cancelled: type: integer minimum: 0 maximum: 9007199254740991 required: - total - passed - failed - cancelled additionalProperties: false required: - id - status - trigger - createdAt - startedAt - finishedAt - gitBranchName - gitCommitSha - gitCommitShaShort - githubRepository - gitlabProjectPath - pipelineId - ciProvider - cliVersion - suite - localSuiteName - labels - runCounts additionalProperties: false pagination: type: object properties: pageSize: type: integer minimum: 1 maximum: 100 hasMore: type: boolean nextCursor: nullable: true type: string total: nullable: true type: integer minimum: 0 maximum: 9007199254740991 required: - pageSize - hasMore - nextCursor - total additionalProperties: false required: - data - pagination additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer ````