---
title: "List replicas"
method: GET
path: "/v1/replica"
tags: ["Replica"]
---

# List replicas

`GET /v1/replica`

## Request

- Base URL: `https://api.replicas.dev`
- URL: `https://api.replicas.dev/v1/replica`
- Auth: HTTP bearer

Lists replicas, newest first. With `status=archived`, sorted by most recent activity.

## Query parameters

- `page` integer
- `limit` integer
- `user_id` string
- `source` 'api' | 'dashboard' | 'slack' | 'linear' | 'github' | 'gitlab' | 'automation'
- `status` 'active' | 'sleeping' | 'archived' | 'preparing' | 'error'

## Headers

- `X-Replicas-Api-Version` '2026-10-07'

## Response `200`

Successful response

- ListReplicasResponse
  - `replicas` ReplicaListItem[], required: Array of workspaces
    - `id` string, uuid, required: Unique identifier for the workspace
    - `name` string, required: Human-readable name for the workspace. Must not contain whitespace.
    - `status` 'active' | 'sleeping' | 'archived' | 'preparing' | 'error', required: Current status of the workspace
    - `source` 'api' | 'dashboard' | 'slack' | 'linear' | 'github' | 'gitlab' | 'automation', required: How the workspace was created
    - `created_at` string, date-time, required: Timestamp when the workspace was created
    - `last_activity_at` string, date-time, nullable, required: Timestamp of the last activity on the workspace
    - `repositories` RepositoryReference[], required: Repositories associated with the workspace
      - `id` string, uuid, required: Repository ID
      - `name` string, required: Repository name
      - `url` string, uri, required: Repository URL
    - `pull_requests` PullRequest[], required: Associated pull requests
      - `repository` string, required: Repository name
      - `number` integer, required: Pull request number
      - `url` string, uri, required: URL to the pull request
  - `total` integer, required: Total number of workspaces matching the filters
  - `page` integer, required: Current page number
  - `limit` integer, required: Number of items per page
  - `total_pages` integer, required: Total number of pages

## Other responses

- `400`: Bad request - Missing or invalid parameters
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

---

[API](https://skmtc.dev/replicas/apis/replicas-api.md) - [All operations](https://skmtc.dev/replicas/apis/replicas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/replicas/apis/replicas-api/revisions/2703ac1c9cb7?raw)