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

# Benchmarks

> List available benchmarks you can run against your model endpoints.

Use this endpoint to retrieve all benchmarks available to your account. Each benchmark defines a specific evaluation suite you can run against your model endpoint by submitting a job.

## Endpoint

```
GET https://api.harmstack.com/v0/benchmarks
```

## Authentication

<ParamField header="Authorization" type="string" required>
  `Bearer YOUR_API_KEY`
</ParamField>

## Request

No query parameters are required.

```bash theme={null}
curl https://api.harmstack.com/v0/benchmarks \
  --header "Authorization: Bearer YOUR_API_KEY"
```

## Response

Returns `200 OK` with a JSON object containing a `benchmarks` array.

<ResponseField name="benchmarks" type="object[]" required>
  Array of benchmark objects available to your account.

  <Expandable title="benchmark fields">
    <ResponseField name="id" type="number" required>
      Unique numeric identifier for the benchmark. Use this value as `benchmark_id` when submitting jobs.
    </ResponseField>

    <ResponseField name="merchant_id" type="number" required>
      Internal identifier for the benchmark publisher.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Internal name of the benchmark (e.g. `"haystack-v1"`).
    </ResponseField>

    <ResponseField name="display_name" type="string" required>
      Human-readable name of the benchmark (e.g. `"Haystack Medical QA v1"`).
    </ResponseField>

    <ResponseField name="version" type="number" required>
      Version number of the benchmark.
    </ResponseField>

    <ResponseField name="benchmark_property_id" type="number">
      ID of the associated benchmark property configuration, if set.
    </ResponseField>

    <ResponseField name="price_per_benchmark_unit" type="number" required>
      Credit cost per benchmark unit submitted.
    </ResponseField>

    <ResponseField name="currency" type="string" required>
      Currency code for the price (e.g. `"USD"`).
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      ISO 8601 timestamp of when the benchmark was created.
    </ResponseField>

    <ResponseField name="updated_at" type="string" required>
      ISO 8601 timestamp of the last update.
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={null}
{
  "benchmarks": [
    {
      "id": 1,
      "merchant_id": 3,
      "name": "haystack-medical-v1",
      "display_name": "Haystack Medical QA v1",
      "version": 1,
      "benchmark_property_id": 12,
      "price_per_benchmark_unit": 1.0,
      "currency": "USD",
      "created_at": "2024-01-15T10:00:00Z",
      "updated_at": "2024-06-01T08:30:00Z"
    }
  ]
}
```

<Tip>
  Copy the `id` from a benchmark object and pass it as `benchmark_id` when
  submitting a job via `POST /v0/jobs`.
</Tip>