> ## Documentation Index > Fetch the complete documentation index at: https://docs.baseten.co/llms.txt > Use this file to discover all available pages before exploring further. # List a team's runs > Lists Loops runs in the given team, visible to the requesting user, optionally filtered by run id and/or base model. ## OpenAPI ````yaml get /v1/teams/{team_id}/loops/runs openapi: 3.1.0 info: description: REST API for management of Baseten resources title: Baseten management API version: 1.0.0 servers: - url: https://api.baseten.co security: - BearerAuth: [] paths: /v1/teams/{team_id}/loops/runs: parameters: - $ref: '#/components/parameters/team_id' get: summary: Lists a team's Loops runs description: >- Lists Loops runs in the given team, visible to the requesting user, optionally filtered by run id and/or base model. parameters: - name: run_id in: query required: false description: Filter by run ID. schema: anyOf: - type: string - type: 'null' default: null examples: - k4q95w5 title: Run Id - name: base_model in: query required: false description: Filter runs by base model name. schema: anyOf: - type: string - type: 'null' default: null examples: - Qwen/Qwen3-8B title: Base Model - name: scope in: query required: false description: >- Defaults to the caller's own runs; pass 'org' to list every run in the caller's organization. schema: anyOf: - type: string - type: 'null' default: null examples: - org title: Scope responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/ListLoopsRunsResponseV1' x-codeSamples: - lang: bash source: | curl --request GET \ --url https://api.baseten.co/v1/teams/{team_id}/loops/runs \ --header "Authorization: Bearer $BASETEN_API_KEY" - lang: python source: |- import requests import os API_KEY = os.environ.get("BASETEN_API_KEY", "") url = "https://api.baseten.co/v1/teams/{team_id}/loops/runs" headers = {"Authorization": f"Bearer {API_KEY}"} response = requests.request( "GET", url, headers=headers, json={} ) print(response.text) components: parameters: team_id: schema: type: string name: team_id in: path required: true schemas: ListLoopsRunsResponseV1: description: Runs matching the query filters. properties: runs: description: List of runs. items: $ref: '#/components/schemas/LoopsRunV1' title: Runs type: array required: - runs title: ListLoopsRunsResponseV1 type: object LoopsRunV1: properties: id: description: The run ID. title: Id type: string session_id: description: The session ID this run belongs to. title: Session Id type: string deployment_id: description: The ID of the Loops deployment the run executes on. title: Deployment Id type: string name: description: The run's display name. title: Name type: string base_model: description: The HuggingFace base model the run is fine-tuning. title: Base Model type: string base_url: description: The run's base URL. title: Base Url type: string created_at: description: Time the run was created in ISO 8601 format format: date-time title: Created At type: string status: $ref: '#/components/schemas/LoopsRunStatusV1' description: The run's current status. user: $ref: '#/components/schemas/UserV1' description: The user who owns the run. sampler: anyOf: - $ref: '#/components/schemas/LoopsSamplerV1' - type: 'null' default: null description: >- The sampler bound to this run, or null for a trainer-only run that has not yet created a sampler. required: - id - session_id - deployment_id - name - base_model - base_url - created_at - status - user title: LoopsRunV1 type: object LoopsRunStatusV1: description: The current status of a Loops run. properties: name: $ref: '#/components/schemas/LoopsRunStatusNameV1' description: >- ACTIVE while the run is live; INACTIVE once replaced by a newer run or shut down. required: - name title: LoopsRunStatusV1 type: object UserV1: description: A user. properties: email: anyOf: - type: string - type: 'null' default: null description: Email of the user. title: Email title: UserV1 type: object LoopsSamplerV1: properties: id: title: Id type: string base_url: title: Base Url type: string base_model: description: The HuggingFace base model the sampler is serving. title: Base Model type: string created_at: description: Time the sampler was created in ISO 8601 format format: date-time title: Created At type: string model_id: description: Hashid of the underlying Baseten model. title: Model Id type: string deployment_id: description: Hashid of the specific model deployment (version). title: Deployment Id type: string status: $ref: '#/components/schemas/LoopsSamplerStatusV1' description: The sampler's current status. user: $ref: '#/components/schemas/UserV1' description: The user who owns the sampler. instance_type: anyOf: - $ref: '#/components/schemas/InstanceTypeV1' - type: 'null' default: null description: Instance type serving the sampler. node_count: default: 1 description: Number of nodes serving the sampler. title: Node Count type: integer required: - id - base_url - base_model - created_at - model_id - deployment_id - status - user title: LoopsSamplerV1 type: object LoopsRunStatusNameV1: description: 'A Loops run''s lifecycle state: ACTIVE or INACTIVE.' enum: - ACTIVE - INACTIVE title: LoopsRunStatusNameV1 type: string LoopsSamplerStatusV1: description: The current status of a Loops sampler. properties: name: $ref: '#/components/schemas/DeploymentStatusV1' description: The current status of the Loops sampler. required: - name title: LoopsSamplerStatusV1 type: object InstanceTypeV1: description: An instance type. properties: id: description: Identifier string for the instance type title: Id type: string name: description: Display name of the instance type title: Name type: string memory_limit_mib: description: Memory limit of the instance type in Mebibytes title: Memory Limit Mib type: integer millicpu_limit: description: CPU limit of the instance type in millicpu title: Millicpu Limit type: integer gpu_count: description: Number of GPUs on the instance type title: Gpu Count type: integer gpu_type: anyOf: - type: string - type: 'null' description: Type of GPU on the instance type title: Gpu Type gpu_memory_limit_mib: anyOf: - type: integer - type: 'null' description: Memory limit of the GPU on the instance type in Mebibytes title: Gpu Memory Limit Mib required: - id - name - memory_limit_mib - millicpu_limit - gpu_count - gpu_type - gpu_memory_limit_mib title: InstanceTypeV1 type: object DeploymentStatusV1: description: The status of a deployment. enum: - BUILDING - DEPLOYING - DEPLOY_FAILED - LOADING_MODEL - ACTIVE - UNHEALTHY - BUILD_FAILED - BUILD_STOPPED - DEACTIVATING - INACTIVE - FAILED - UPDATING - SCALED_TO_ZERO - WAKING_UP title: DeploymentStatusV1 type: string securitySchemes: BearerAuth: type: http scheme: bearer description: >- Send `Authorization: Bearer `. The legacy `Authorization: Api-Key ` scheme is also accepted. ````