---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://www.servicenow.com/docs/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Metrics API

# Quote Experience metrics API {#ariaid-title1}

Release version: Brazil  
Updated May 7, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Reference for the Quote Experience metrics API, including query parameters, default behavior, and metric definitions for views, session time, and stage time in ServiceNow CPQ.

## Overview of metrics {#quote-tm-metrics-api__overview}

The Quote Experience metrics API retrieves usage data on transactions, including views by user, session time by user, and stage time. Administrators and implementers use this API to understand how users interact with quotes
and how long transactions spend at each stage.

You can query a single transaction by providing its transaction ID. If no transaction ID is provided, the API returns data for all transactions within the specified time period.

## Endpoint {#quote-tm-metrics-api__endpoint}

    GET {{baseUrl}}/api/txn/metrics/v1/overview

## Query parameters {#quote-tm-metrics-api__parameters}

{#quote-tm-metrics-api__parameters__entry__4}

| Parameter | Type | Required | Description |
|-|-|-|-|
| `txnId` | String | No | The ID of the transaction to query. When provided, the response contains metrics for that transaction only. When omitted, the response contains metrics for all transactions in the specified time period. |
| `days` | Integer | No | The number of days to include in the query, counting back from `toDate`. The queried period is `(toDate - days) → toDate`. Defaults to `30` when not specified. |
| `toDate` | Timestamp | No | The end date and time for the query period in UTC format --- for example, `2025-09-18T15:28:04Z`. When omitted, the current time is used. |
[Table 1. Metrics API query parameters]

## Required headers {#quote-tm-metrics-api__headers}

{#quote-tm-metrics-api__headers__entry__2}

| Header | Value |
|-|-|
| `X-Logik-Customer-Id` | Your tenant ID. |
| `Content-Type` | `application/json` |
[Table 2. Request headers]

## Example call {#quote-tm-metrics-api__example-call}

    curl -X GET \
      "{{baseUrl}}/api/txn/metrics/v1/overview?txnId={{transactionId}}&days=30&toDate=2025-09-18T15:28:04Z" \
      -H "X-Logik-Customer-Id: <tenant-id>" \
      -H "Content-Type: application/json"

## Metric definitions {#quote-tm-metrics-api__metric-definitions}

{#quote-tm-metrics-api__metric-definitions__entry__4}

| Metric | Description | Unit | Notes |
|-|-|-|-|
| Views by user | The total number of sessions for a user in the specified time period. | Count | When filtered to a single transaction using `txnId`, sessions are counted for that transaction only. |
| Session time by user | The average time per session for each user in the specified time period. | Minutes | Sessions are calculated using activity windows based on common events, including transaction created or edited, stage enter or exit, upsert lines, and custom transaction events. A session ends five minutes after the last recorded event. When filtered to a single transaction, the total time for a user can be calculated as: `views per user × session time per user`. |
| Stage time | The average time a transaction spends in a specified stage. | Minutes | When filtered to a single transaction, the metric reflects the time that specific transaction spent in the specified stage. |
[Table 3. ServiceNow Quote Experience metrics]