> For the complete documentation index, see [llms.txt](https://docs.cuoral.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuoral.com/api-reference/customers/metrics/list-metric-definitions.md).

# List Metric Definitions

GET /external/v1/external/v1/customers/metrics

### Request 

#### Parameters

* None

### Responses

#### Successful Response (200) (application/json)

Returns an array of metric definition objects.

| **Field**        | **Type**            | **Description**                                                                          |
| ---------------- | ------------------- | ---------------------------------------------------------------------------------------- |
| id               | `integer`           | The internal database ID of the definition.                                              |
| metric\_id       | `string`            | The unique external ID assigned to the metric.                                           |
| name             | `string`            | The human-readable name of the metric.                                                   |
| description      | `string`            | A detailed description of what the metric tracks.                                        |
| data\_type       | `string`            | The expected data type for the values of this metric (e.g., `STRING`, `NUMBER`, `DATE`). |
| organization\_id | `integer`           | The organization ID this metric belongs to.                                              |
| time\_created    | `string` (datetime) | Creation timestamp.                                                                      |
| time\_updated    | `string` (datetime) | Last update timestamp.                                                                   |

Example Response Body (200):

```json
[
  {
    "id": 1,
    "metric_id": "ARR",
    "name": "Annual Recurring Revenue",
    "description": "Total yearly contract value.",
    "data_type": "NUMBER",
    "organization_id": 42,
    "time_created": "2025-11-20T10:00:00.000Z",
    "time_updated": "2025-11-27T10:09:07.006Z"
  },
  {
    "id": 2,
    "metric_id": "TIER",
    "name": "Customer Tier",
    "description": "Service level tier.",
    "data_type": "STRING",
    "organization_id": 42,
    "time_created": "2025-11-22T10:00:00.000Z",
    "time_updated": "2025-11-22T10:00:00.000Z"
  }
]
```