> ## Documentation Index > Fetch the complete documentation index at: https://docs.scorecard.io/llms.txt > Use this file to discover all available pages before exploring further. # List systems > Retrieve a paginated list of all systems. Systems are ordered by creation date. ## OpenAPI ````yaml get /projects/{projectId}/systems openapi: 3.1.0 info: title: Scorecard API description: REST API for Scorecard version: 1.0.0 servers: - url: https://api2.scorecard.io/api/v2 security: - ApiKeyAuth: [] paths: /projects/{projectId}/systems: get: summary: List systems description: >- Retrieve a paginated list of all systems. Systems are ordered by creation date. operationId: listSystems parameters: - in: path name: projectId description: The ID of the system's Project. schema: type: string example: '314' required: true - in: query name: limit description: >- Maximum number of items to return (1-100). Use with `cursor` for pagination through large sets. schema: type: integer exclusiveMinimum: 0 default: 20 example: 20 - in: query name: cursor description: >- Cursor for pagination. Pass the `nextCursor` from the previous response to get the next page of results. schema: type: string example: eyJvZmZzZXQiOjAsInBhZ2VJZCI6ImNvZGUifQ responses: '200': description: Successfully retrieved list of systems. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/System' nextCursor: type: - string - 'null' hasMore: type: boolean total: type: integer minimum: 0 required: - data - nextCursor - hasMore examples: System list with pagination: value: data: - id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 name: GPT-4 Chatbot description: Production chatbot powered by GPT-4 productionVersion: id: 87654321-4d3b-4ae4-8c7a-4b6e2a19ccf0 systemId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 name: Version 2 (Low Temperature) config: temperature: 0.1 maxTokens: 1024 versions: - id: 87654321-4d3b-4ae4-8c7a-4b6e2a19ccf0 name: Version 2 (Low Temperature) - id: 87654321-4d3b-4ae4-8c7a-4b6e2a19ccf1 name: Version 1 (High Temperature) - id: 8fb15f74-2918-4982-a4fc-9c157f77dca7 name: RAG System description: >- Retrieval-augmented generation system for company knowledge base productionVersion: id: 87654321-4d3b-4ae4-8c7a-4b6e2a19ccf4 systemId: 8fb15f74-2918-4982-a4fc-9c157f77dca7 name: Best version config: top_k: 2 chunk_size: 512 versions: - id: 87654321-4d3b-4ae4-8c7a-4b6e2a19ccf4 name: Best version nextCursor: 8fb15f74-2918-4982-a4fc-9c157f77dca8 hasMore: true summary: System list with pagination description: Example response showing a paginated list of two systems. '401': $ref: '#/components/responses/UnauthenticatedError' '500': $ref: '#/components/responses/ServiceError' x-codeSamples: - lang: JavaScript source: |- import Scorecard from 'scorecard-ai'; const client = new Scorecard({ apiKey: 'My API Key', }); // Automatically fetches more pages as needed. for await (const system of client.systems.list('314')) { console.log(system.id); } - lang: Python source: |- from scorecard_ai import Scorecard client = Scorecard( api_key="My API Key", ) page = client.systems.list( project_id="314", ) page = page.data[0] print(page.id) - lang: cURL source: |- curl https://api2.scorecard.io/api/v2/projects/$PROJECT_ID/systems \ -H "Authorization: Bearer $SCORECARD_API_KEY" components: schemas: System: type: object properties: id: type: string format: uuid description: The ID of the system. name: type: string description: The name of the system. Unique within the project. description: type: string default: '' description: The description of the system. productionVersion: $ref: '#/components/schemas/SystemVersion' description: The production version of the system. versions: type: array items: type: object properties: id: type: string format: uuid description: The ID of the system version. name: type: string description: The name of the system version. required: - id - name description: >- A SystemVersion defines the specific settings for a System Under Test. System versions contain parameter values that determine system behavior during evaluation. They are immutable snapshots - once created, they never change. When running evaluations, you reference a specific systemVersionId to establish which system version to test. description: The versions of the system. required: - id - name - description - productionVersion - versions description: >- A System Under Test (SUT). Systems are templates - to run evaluations, pair them with a SystemVersion that provides specific parameter values. SystemVersion: type: object properties: id: type: string format: uuid description: The ID of the system version. systemId: type: string format: uuid description: The ID of the system the system version belongs to. name: type: string description: The name of the system version. config: type: object additionalProperties: true description: The configuration of the system version. required: - id - systemId - name - config description: >- A SystemVersion defines the specific settings for a System Under Test. System versions contain parameter values that determine system behavior during evaluation. They are immutable snapshots - once created, they never change. When running evaluations, you reference a specific systemVersionId to establish which system version to test. ApiError: type: object properties: code: type: string message: type: string details: type: object additionalProperties: true x-stainless-any: true required: - code - message - details description: An API error. responses: UnauthenticatedError: description: Error indicating that the request is not authenticated. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: Authentication failure: value: code: UNAUTHORIZED message: Invalid or missing authentication token details: {} summary: Authentication failure description: >- Error returned when authentication credentials are invalid or missing. ServiceError: description: >- An internal service error indicating an issue with the Scorecard service. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: Internal error: value: code: INTERNAL_ERROR message: An unexpected error occurred while processing your request. details: {} summary: Internal error description: Generic error when an unexpected internal issue occurs. securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: starts with ak_ ````