> ## 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 deployments > Lists Loops deployments. Defaults to the caller's own; pass ?scope=org to list every deployment in the caller's organization. Returns every deployment regardless of status; clients filter terminal states. ## OpenAPI ````yaml get /v1/loops/deployments 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/loops/deployments: get: summary: Lists Loops deployments description: >- Lists Loops deployments. Defaults to the caller's own; pass ?scope=org to list every deployment in the caller's organization. Returns every deployment regardless of status; clients filter terminal states. parameters: - name: scope in: query required: false description: >- Defaults to the caller's own deployments; pass 'org' to list every deployment 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/ListLoopsDeploymentsResponseV1' x-codeSamples: - lang: bash source: | curl --request GET \ --url https://api.baseten.co/v1/loops/deployments \ --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/loops/deployments" headers = {"Authorization": f"Bearer {API_KEY}"} response = requests.request( "GET", url, headers=headers, params={'scope': 'org'} ) print(response.text) components: schemas: ListLoopsDeploymentsResponseV1: description: >- Response for ``GET /v1/loops/deployments``. Defaults to the caller's own; pass ``?scope=org`` to list every deployment in the caller's organization. Returns every deployment regardless of status; clients filter terminal states. properties: deployments: description: Active Loops deployments. items: $ref: '#/components/schemas/LoopsDeploymentV1' title: Deployments type: array required: - deployments title: ListLoopsDeploymentsResponseV1 type: object LoopsDeploymentV1: description: |- A Loops deployment — the long-lived run + sampler pair owned by a user. The deployment's current sampler is included inline. The full list of samplers visible to the caller (across all deployments) lives at ``GET /v1/loops/samplers``. properties: id: description: The Loops deployment ID. title: Id type: string active_run_id: anyOf: - type: string - type: 'null' default: null description: >- The ID of the run currently active on this deployment, if any. Null when the deployment's runs have been marked inactive (e.g. scale-to-zero) without a successor. title: Active Run Id latest_run_id: anyOf: - type: string - type: 'null' default: null description: >- The ID of the most recent run on this deployment, active or not, so idle deployments still expose a usable run handle. Null only if the deployment has no runs. title: Latest Run Id base_model: description: The HuggingFace base model the deployment is fine-tuning. title: Base Model type: string base_url: description: The run's base URL. title: Base Url type: string status: $ref: '#/components/schemas/LoopsDeploymentStatusV1' description: Latest deployment status. user: $ref: '#/components/schemas/UserV1' description: The user who owns the Loops deployment. created_at: description: Time the deployment was created in ISO 8601 format. format: date-time title: Created At type: string availability_model: $ref: '#/components/schemas/V1AvailabilityModel' default: dedicated description: Capacity the trainer was scheduled on. instance_type: $ref: '#/components/schemas/InstanceTypeV1' description: Instance type backing the trainer. node_count: default: 1 description: Number of nodes backing the trainer. title: Node Count type: integer sampler: anyOf: - $ref: '#/components/schemas/LoopsSamplerV1' - type: 'null' default: null description: The sampler bound to this deployment. required: - id - base_model - base_url - status - user - created_at - instance_type title: LoopsDeploymentV1 type: object LoopsDeploymentStatusV1: description: Latest deployment status for a Loops deployment. properties: name: $ref: '#/components/schemas/Name' description: Latest status of the Loops deployment. required: - name title: LoopsDeploymentStatusV1 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 V1AvailabilityModel: description: >- Capacity guarantee under which a training job is scheduled. ``DEDICATED`` is on-demand capacity that is not preempted (the default). ``SPOT`` is interruptible capacity that may be preempted; the user is responsible for checkpointing their own progress. A managed/resumable model where the platform handles checkpoint/resume on its own is intentionally not defined yet; it is planned for a future milestone. enum: - dedicated - spot title: V1AvailabilityModel type: string 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 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 Name: enum: - CREATED - DEPLOYING - RUNNING - SCALED_TO_ZERO - FAILED - STOPPED - PREEMPTED title: LoopsDeploymentStatus 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 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. ````