---
title: "Get an actor."
method: GET
path: "/actor/{actor}"
tags: ["Domain management"]
---

# Get an actor.

`GET /actor/{actor}`

## Path parameters

- `actor` string, required

## Response `200`

Actor retrieved.

- Actor — An actor.
  - `identifier` string, required — The actor's unique identifier in the specification, used to refer to it from test cases.
  - `name` string, required — The actor's display name.
  - `description` string — The actor's description.
  - `reportMetadata` string — The actor's additional metadata for XML reports.
  - `default` boolean — Whether the actor should be considered as the default choice for new conformance statements within its specification.
  - `hidden` boolean — Whether the actor should be hidden.
  - `displayOrder` number — The actor's display order relative to other actors when presented in test execution diagrams.
  - `apiKey` string, required — The actor's API key.

## Other responses

- `429` — Call rate limit threshold exceeded for this operation.
- `default` — The received request was invalid.

## Changes

> 29 revisions in range; 1 could not be searched.

- **2026-03-19** `7637660a4a6b` — 1 info
  - added the non-success response with the status `429`
- **2025-08-05** `d4d8abc40bb2` — 1 info
  - endpoint added
- **2022-06-27** `06f633c06bcd` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/changes/actor/:actor/get.md)

---

[API](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api.md) · [All operations](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ec-jrc/interoperability-test-bed-rest-api/revisions/433b3c0ae6d4/schema)