Skip to main content
GET
/
v1
/
analytics
/
scoring-latency
nova-embed
import { Nova } from "nova-embed";

const nova = new Nova({
  apiKey: "sk_test_...",
  tenantId: "acme-corp",
});

const latency = await nova.analytics.scoringLatency({ timeRange: "24h" });
{
  "period": {
    "start": "2023-11-07T05:31:56Z",
    "end": "2023-11-07T05:31:56Z"
  },
  "granularity": "minute",
  "data": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "p50Ms": 123,
      "p95Ms": 123,
      "p99Ms": 123
    }
  ]
}
Returns percentile breakdowns of end-to-end scoring duration over time. Useful for tracking performance trends and identifying latency spikes. This endpoint requires only a valid API key. X-Tenant-Id isn’t required.

​
Query parameters

ParameterRequiredValuesDescription
timeRangeYes1h, 24h, 7d, 30d, 90dLookback window for the data

​
Example response

{
  "period": {
    "start": "2026-03-07T00:00:00.000Z",
    "end": "2026-03-08T00:00:00.000Z"
  },
  "granularity": "hour",
  "data": [
    {
      "timestamp": "2026-03-07T12:00:00.000Z",
      "p50Ms": 800,
      "p95Ms": 2000,
      "p99Ms": 3500
    },
    {
      "timestamp": "2026-03-07T13:00:00.000Z",
      "p50Ms": 750,
      "p95Ms": 1800,
      "p99Ms": 3200
    }
  ]
}

​
Response fields

FieldTypeDescription
period.startstringISO 8601 start of the period
period.endstringISO 8601 end of the period
granularitystringBucket size for each data point
data[].timestampstringISO 8601 timestamp for this bucket
data[].p50Msnumber | nullMedian scoring duration in milliseconds
data[].p95Msnumber | null95th percentile scoring duration in milliseconds
data[].p99Msnumber | null99th percentile scoring duration in milliseconds
P50 reflects the typical scoring experience. P95 and P99 surface tail latency that affects a small fraction of requests but can indicate bottlenecks.
Responses are cached for 60 seconds (Cache-Control: private, max-age=60). This endpoint is rate-limited under the analytics bucket (20 req/s).

Authorizations

​
Authorization
string
header
required

Use Authorization: Bearer sk_test_* or Authorization: Bearer sk_live_*.

Query Parameters

​
timeRange
enum<string>
required

Time range for the analytics query Time range for analytics queries.

Available options:
1h,
24h,
7d,
30d,
90d

Response

Scoring latency percentiles

​
period
object
required
​
granularity
enum<string>
required

Time bucket granularity

Available options:
minute,
hour,
day
​
data
object[]
required