List imported business metrics

GET

/api/v1/business-metrics

const url = 'https://example.com/api/v1/business-metrics';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/v1/business-metrics

Lists the default tenant’s user-authored business metrics and their inclusive stored day spans, sorted by name. These business-value counts are separate from vendor usage metrics and never appear in the AI Usage endpoint.

Responses

200

Business metric names and available day spans.

application/json

object

metrics

required

Imported business metrics, sorted by name; never null.

Array<object>

object

name

required

Exact metric identity used by the unit-economics query.

string

firstDay

required

First stored UTC calendar day.

string format: date

lastDay

required

Last stored UTC calendar day.

string format: date

Example

{
  "metrics": [
    {
      "name": "requests served",
      "firstDay": "2026-05-01",
      "lastDay": "2026-05-31"
    }
  ]
}

500

The business-metric list query failed.

text/plain

string