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

# List Replicas

`GET /v1/replica`

Returns a paginated list of all replicas in your organization. Supports filtering by user, source, and status. For this API endpoint, results are ordered by newest `created_at` first, except `status=archived` results are ordered by most recent activity (`last_activity_at`, falling back to `created_at`).

## Query parameters

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

## Response `200`

Successful response

- ListReplicasResponse
  - `replicas` ReplicaListItem[], required — Array of replicas
    - `id` string, uuid, required — Unique identifier for the replica
    - `name` string, required — Human-readable name for the replica. Must not contain whitespace.
    - `status` 'active' | 'sleeping' | 'archived' | 'preparing' | 'error', required — Current status of the replica
    - `source` 'api' | 'dashboard' | 'slack' | 'linear' | 'github' | 'gitlab' | 'automation', required — How the replica was created
    - `created_at` string, date-time, required — Timestamp when the replica was created
    - `last_activity_at` string, date-time, nullable, required — Timestamp of the last activity on the replica
    - `repositories` RepositoryReference[], required — Repositories associated with the replica
      - `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 replicas 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.net/tryreplicas/apis/replica-api.md) · [All operations](https://skmtc.net/tryreplicas/apis/replica-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryreplicas/replica-api/revisions/aa3b4c932f7a/schema)