---
title: "## Datacenter Round Trips"
method: GET
path: "/actors"
tags: ["actors::list"]
---

# ## Datacenter Round Trips

`GET /actors`

**If key is some & `include_destroyed` is false**

 2 round trips:
 - namespace::ops::resolve_for_name_global
 - GET /actors (multiple DCs based on actor IDs)

	This path is optimized because we can read the actor IDs fro the key directly from Epoxy with
	stale consistency to determine which datacenter the actor lives in. Under most circumstances,
	this means we don't need to fan out to all datacenters (like normal list does).

	The reason `include_destroyed` has to be false is Epoxy only stores currently active actors. If
	`include_destroyed` is true, we show all previous iterations of actors with the same key.

 **Otherwise**

 2 round trips:
 - namespace::ops::resolve_for_name_global
 - GET /actors (fanout)

 ## Optimized Alternative Routes

## Query parameters

- `namespace` string, required
- `name` string
- `key` string
- `actor_ids` string
- `actor_id` RivetId[]
- `include_destroyed` boolean
- `limit` integer
- `cursor` string

## Response `200`

- ActorsListResponse
  - `actors` Actor[], required
    - `actor_id` string, required
    - `connectable_ts` integer, nullable — Denotes when the actor was last connectable. Null if actor is not running.
    - `crash_policy` 'restart' | 'sleep' | 'destroy', required
    - `create_ts` integer, required — Denotes when the actor was first created.
    - `datacenter` string, required
    - `destroy_ts` integer, nullable — Denotes when the actor was destroyed.
    - `error` object, nullable — Error details if the actor failed to start.
    - `key` string, nullable
    - `name` string, required
    - `namespace_id` string, required
    - `pending_allocation_ts` integer, nullable — Denotes when the actor started waiting for an allocation.
    - `reschedule_ts` integer, nullable — Denotes when the actor will try to allocate again. If this is set, the actor will not attempt to allocate until the given timestamp.
    - `runner_name_selector` string, required
    - `sleep_ts` integer, nullable — Denotes when the actor entered a sleeping state.
    - `start_ts` integer, nullable — Denotes when the actor was first made connectable. Null if never.
  - `pagination` Pagination, required
    - `cursor` string, nullable

---

[API](https://skmtc.dev/rivet-dev/apis/rivet-api-public.md) · [All operations](https://skmtc.dev/rivet-dev/apis/rivet-api-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rivet-dev/rivet-api-public/revisions/a22e2e3f6322/schema)