---
title: "List scorers"
method: GET
path: "/api/{org_id}/scorers"
tags: ["Scorers"]
---

# List scorers

`GET /api/{org_id}/scorers`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/scorers`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/scorers/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists scorers in the organization. Filterable by scorer_type query parameter.

## Path parameters

- `org_id` string, required

## Query parameters

- `scorerType` string

## Response `200`

- object: HTTP response body for listing Scorers.
  - `list` ScorerResponseBody[], required
    - `createdAt` integer, required
    - `description` string, nullable
    - `entityId` string, required
    - `id` string, required
    - `isActive` boolean, required
    - `name` string, required
    - `orgId` string, required
    - `outputSchema` unknown
    - `params` unknown, required
    - `producesScoreConfigId` string, nullable
    - `producesScoreConfigVersion` integer, nullable
    - `referenceBased` boolean, required: True when the scorer contract declares the `expected_output` variable.
    - `scorerType` string, required
    - `template` string, required
    - `updatedAt` integer, required
    - `variables` string[], required
    - `version` integer, required

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)