List Metric Definitions

List all metric definitions that have been created for the organization.

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):

[
  {
    "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"
  }
]