---
title: "Retrieve a Stateful Actor type"
method: GET
path: "/compute/actors/{id}"
tags: ["stateful actors"]
---

# Retrieve a Stateful Actor type

`GET /compute/actors/{id}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/compute/actors/{id}`
- Auth: HTTP bearer

Retrieve one account-scoped Stateful Actor type. owner_function_id identifies the function that owns and ships the actor class; other functions may reference the same actor type through actor bindings.

## Path parameters

- `id` string, required

## Response `200`

Actor type retrieved successfully

- ComputeActorTypeResponse
  - `data` ComputeActorType
    - `record_type` string
    - `id` string
    - `type` string
    - `status` string
    - `owner_function_id` string: ID of the function that owns and ships this actor type. Empty when the type is unowned.
    - `created_at` string
    - `updated_at` string
    - `placement` ActorPlacement: Last deployment fan-out report, not a live probe. Omitted on actor types without a placement-aware deployment.
      - `policy` 'everywhere' | 'single_site'
      - `clusters` string[]: Public regions with successful deployment
      - `excluded_clusters` string[]
      - `unchecked_clusters` string[]
      - `partial` boolean
      - `observed_at` string: Optional ISO-8601 millisecond timestamp
      - `cluster_results` ActorClusterResult[]
        - `cluster_id` string: Public region, or unknown when no mapping exists
        - `status` string
        - `success` boolean
        - `error` string
        - `error_code` string

## Other responses

- `401`: Unauthorized
- `404`: Actor type not found
- `422`: Invalid actor type ID
- `500`: Internal server error

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-21** `0663104b73bd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/compute/actors/:id/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)