---
title: "Get Paladins by name"
method: GET
path: "/paladin/name/{paladin_name}"
tags: ["paladin"]
---

# Get Paladins by name

`GET /paladin/name/{paladin_name}`

Returns all Paladins whose name exactly matches the given name. Names are not unique, so the result is a list and may be empty.

## Path parameters

- `paladin_name` string, required

## Response `200`

The list of Paladins matching the passed-in name.

- PaladinList — # PaladinList Object ### Description A list of `Paladin` objects.
  - `results` Paladin[], required
    - `paladin_id` string, uuid, required — The ID of the Paladin. Use this value as a reviewer in a request configuration's service_user_ids.
    - `name` string, required — The name of the Paladin.
    - `owner_id` string, uuid, required — The ID of the owner of the Paladin.
    - `monitor_mode` boolean, required — When true, the Paladin reasons about requests but takes no action. Shown as "Monitor mode" in the UI.
    - `admin_view_only` boolean, required — When true, the Paladin's recommendations are visible only to admins. Only meaningful when monitor_mode is true.
    - `enabled_connectors` PaladinConnector[], required — The connectors the Paladin is allowed to use.
    - `instructions` string, required — The free-form instructions that guide the Paladin's decisions.

---

[API](https://skmtc.net/opal/apis/opal-api.md) · [All operations](https://skmtc.net/opal/apis/opal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opal/opal-api/revisions/35a0d1b09a5d/schema)