# Metric Definitions

> List the metric definitions available on a deal, with the metric_id and value_type needed to record a fact, in the Lev API.

Source: https://www.lev.com/docs/build/index/metric-definitions

Last updated: 2026-09-16

---
### `GET /api/external/v2/deals/{deal_id}/index/metric-definitions`

List the metric definitions that can be recorded on a deal

#### Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `deal_id` | `integer` | Yes | The deal ID |

#### Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `metric_label` | `string` | No | Case-insensitive search term to filter by metric label (for example, noi). |
| `category_id` | `integer` | No | Filter to a single metric category id (greater than 0). |
| `page` | `integer` | No | 1-based page number. Defaults to 1. |
| `limit` | `integer` | No | Metric definitions per page. Defaults to 100 and is clamped to 1-200. |

Response: `200`

#### Error Responses

- **422** (validation_error): limit must be an integer
- **401** (unauthorized): Authentication required
- **404** (not_found): Deal not found
- **503** (service_unavailable): Deal metric definitions are temporarily unavailable. Please try again shortly.