> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weflayr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get evaluators

> Get the evaluators a benchmark can score with.

Get the [evaluators](https://docs.weflayr.com/product/evaluators.md) you can use in a benchmark, by id: the built-in ones Weflayr wrote, and the ones of your project. An always-used evaluator is in every benchmark. Write your own with set\_evaluator, or have AI write them for a saved setup with generate\_evaluators.

## Parameters

**cursor** `string`

The route is paginated: pass the previous page's `next_cursor`, as is, to get the next page. `has_more` says whether another page exists.

**limit** `integer` (default: 100)

Number of evaluators per page. Max `1000`.

The response also carries `blockers` (what prevents the usual next step), in plain words. It is empty when the usual workflow applies.

```python Python theme={null}
import weflayr

client = weflayr.client()  # reads WEFLAYR_API_KEY

client.get_evaluators(limit=20)
```

```js Node.js theme={null}
const weflayr = require('weflayr');

const client = weflayr.client(); // reads WEFLAYR_API_KEY

await weflayr.api.getEvaluators({
  client,
  throwOnError: true,
  query: {
    limit: 20,
  },
});
```

```bash cURL theme={null}
curl "https://app.weflayr.com/api/evaluators/?limit=20" \
  -H "Authorization: Bearer $WEFLAYR_API_KEY"
```

```json 200 theme={null}
{
  "evaluators": [
    {
      "evaluator_id": 1,
      "name": "Overall quality",
      "kind": "judge",
      "instruction": "The answer is as good as the baseline's.",
      "builtin": true,
      "always_used": true,
      "in_library": false,
      "generated": false
    },
    {
      "evaluator_id": 14,
      "name": "Polite tone",
      "kind": "judge",
      "instruction": "The answer is polite and never blames the customer.",
      "builtin": false,
      "always_used": false,
      "in_library": true,
      "generated": false
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "blockers": []
}
```

```json 401 theme={null}
{"error": "Invalid or missing API key. Send it as \"Authorization: Bearer <your key>\"."}
```

```json 422 theme={null}
{"error": "Invalid request payload.", "detail": [{"field": "limit", "error": "Input should be less than or equal to 1000"}]}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.