> ## Documentation Index > Fetch the complete documentation index at: https://docs.firedrill.run/llms.txt > Use this file to discover all available pages before exploring further. # List hosted drill suites in a project > Lists repository-owned CI suites across pull requests, pushes, schedules, manual workflows, and generic service-credential runners. Results are newest first. A cursor is valid only for the same project and filters. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/projects/{projectId}/ci-suites openapi: 3.1.0 info: title: Firedrill Control API version: 1.0.0 description: >- The control plane for drills, drill runs, and the worlds they run in. Errors always carry the canonical envelope; unsafe operations require an Idempotency-Key; long work returns an operation resource. servers: - url: https://api.firedrill.run security: - controlCredential: [] paths: /v1/projects/{projectId}/ci-suites: get: summary: List hosted drill suites in a project description: >- Lists repository-owned CI suites across pull requests, pushes, schedules, manual workflows, and generic service-credential runners. Results are newest first. A cursor is valid only for the same project and filters. operationId: ci.suites.list parameters: - name: projectId in: path required: true schema: type: string pattern: ^prj_[0-9a-z]{12,32}$ - name: cursor in: query required: false schema: type: string minLength: 1 maxLength: 2048 - name: limit in: query required: false schema: default: 20 type: integer minimum: 0 exclusiveMinimum: true maximum: 100 - name: environmentId in: query required: false schema: type: string pattern: ^env_[0-9a-z]{12,32}$ - name: provider in: query required: false schema: type: string enum: - github_actions - service - simulation - name: state in: query required: false schema: type: string enum: - preparing - running - cancelling - completed - failed - cancelled - name: conclusion in: query required: false schema: type: string enum: - passed - failed - inconclusive - error - cancelled responses: '200': description: Hosted drill suites content: application/json: schema: $ref: '#/components/schemas/CiSuitePage' default: description: Canonical error envelope content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: CiSuitePage: type: object properties: items: maxItems: 100 type: array items: type: object properties: schemaVersion: type: number enum: - 1 ciSuiteId: type: string pattern: ^cisuite_[0-9a-z]{12,32}$ organizationId: type: string pattern: ^org_[0-9a-z]{12,32}$ projectId: type: string pattern: ^prj_[0-9a-z]{12,32}$ environmentId: type: string pattern: ^env_[0-9a-z]{12,32}$ repositoryBindingId: type: string pattern: ^repo_[0-9a-z]{12,32}$ provider: type: string enum: - github_actions - service - simulation suiteKey: type: string minLength: 1 maxLength: 96 pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ source: anyOf: - oneOf: - type: object properties: kind: type: string enum: - single_revision candidateRevision: type: string pattern: ^[0-9a-f]{40}$ required: - kind - candidateRevision additionalProperties: false - type: object properties: kind: type: string enum: - revision_comparison baseRevision: type: string pattern: ^[0-9a-f]{40}$ candidateRevision: type: string pattern: ^[0-9a-f]{40}$ required: - kind - baseRevision - candidateRevision additionalProperties: false - type: object properties: kind: type: string enum: - pinned_build buildHash: type: string pattern: ^sha256:[0-9a-f]{64}$ planId: type: string pattern: ^simplan_[0-9a-z]{12,32}$ planDigest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - kind - buildHash - planId - planDigest additionalProperties: false evidenceUrl: type: string maxLength: 2048 format: uri state: type: string enum: - preparing - running - cancelling - completed - failed - cancelled conclusion: type: string enum: - passed - failed - inconclusive - error - cancelled version: type: integer minimum: -9007199254740991 maximum: 9007199254740991 counts: type: object properties: logicalCases: type: integer minimum: -9007199254740991 maximum: 9007199254740991 attemptCases: type: integer minimum: -9007199254740991 maximum: 9007199254740991 pending: type: integer minimum: -9007199254740991 maximum: 9007199254740991 active: type: integer minimum: -9007199254740991 maximum: 9007199254740991 passed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 failed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 inconclusive: type: integer minimum: -9007199254740991 maximum: 9007199254740991 error: type: integer minimum: -9007199254740991 maximum: 9007199254740991 cancelled: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - logicalCases - attemptCases - pending - active - passed - failed - inconclusive - error - cancelled additionalProperties: false createdAtMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 updatedAtMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 finishedAtMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - schemaVersion - ciSuiteId - organizationId - projectId - environmentId - provider - suiteKey - source - evidenceUrl - state - version - counts - createdAtMs - updatedAtMs additionalProperties: false nextCursor: type: string minLength: 1 maxLength: 2048 required: - items additionalProperties: false ErrorEnvelope: type: object properties: code: type: string pattern: ^(control|world)\.[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$ message: type: string minLength: 1 correlationId: type: string minLength: 1 retryable: type: boolean retryAfterMs: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 operationId: type: string source: type: string enum: - platform - simulated_provider issues: type: array items: type: object properties: path: type: string code: type: string message: type: string required: - path - code - message additionalProperties: false details: type: object propertyNames: type: string additionalProperties: {} evidence: type: object properties: sessionId: type: string runId: type: string journalSeq: type: integer minimum: 0 maximum: 9007199254740991 buildHash: type: string additionalProperties: false required: - code - message - correlationId - retryable - source additionalProperties: true securitySchemes: controlCredential: type: http scheme: bearer description: Opaque control credential ````