# Analytics

## Endpoints

- `GET /platform/analytics/metrics`: [Export team analytics metrics](https://docs.polymorfa.com/api/analytics/export-team-analytics-metrics)
- `GET /platform/projects/{projectId}/analytics/metrics`: [Export project analytics metrics](https://docs.polymorfa.com/api/analytics/export-project-analytics-metrics)
- `GET /platform/analytics`: [Read team analytics](https://docs.polymorfa.com/api/analytics/read-team-analytics)
- `GET /platform/projects/{projectId}/analytics`: [Read project analytics](https://docs.polymorfa.com/api/analytics/read-project-analytics)

## The WhatsApp analytics object

### Attributes

- `enabled` (boolean, required). Whether this feature is enabled.
- `period` (object, required). Structured period values for this management whats app analytic.
  - `start` (integer, required). Unix milliseconds.
  - `end` (integer, required). Unix milliseconds.
- `requestVitals` (object, required). Structured request vitals values for this management whats app analytic.
  - `requests` (integer, required, min 0). Specifies requests for this request vital.
  - `failures` (integer, required, min 0). Specifies failures for this request vital.
  - `errorRate` (number, required, nullable, range 0–1). Specifies error rate for this request vital.
- `summary` (object, required, nullable). Structured summary values for this management whats app analytic.
  - `measured` (boolean, required). Whether measured.
  - `observedHours` (integer, required, min 0). Specifies observed hours for this all of.
  - `lastObservedAt` (integer, required, nullable). Unix milliseconds.
  - `outgoingMessages` (integer, required, min 0). Specifies outgoing messages for this all of.
  - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this all of.
  - `sendAttempts` (integer, required, min 0). Specifies send attempts for this all of.
  - `sendFailures` (integer, required, min 0). Specifies send failures for this all of.
  - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this all of.
  - `businessReplies` (integer, required, min 0). Specifies business replies for this all of.
  - `averageBusinessResponseMs` (number, required, nullable, min 0). Specifies average business response ms for this all of.
  - `onlineMs` (integer, required, min 0). Specifies online ms for this all of.
  - `disconnects` (integer, required, min 0). Specifies disconnects for this all of.
  - `connectFailures` (integer, required, min 0). Specifies connect failures for this all of.
  - `streamErrors` (integer, required, min 0). Specifies stream errors for this all of.
  - `keepaliveTimeouts` (integer, required, min 0). Specifies keepalive timeouts for this all of.
  - `engagement` (object, required). Structured engagement values for this all of.
    - `windowHours` (integer, required). Specifies window hours for this engagement. Values: `24`.
    - `completedConversations` (integer, required, min 0). Specifies completed conversations for this engagement.
    - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this engagement.
    - `readConversations` (integer, required, min 0). Specifies read conversations for this engagement.
    - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this engagement.
    - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this engagement.
    - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this engagement.
    - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this engagement.
    - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this engagement.
    - `complete` (boolean, required). Whether complete.
    - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this engagement.
    - `droppedRecords` (integer, required, min 0). Specifies dropped records for this engagement.
    - `droppedReceiptJoins` (integer, required, min 0). Specifies dropped receipt joins for this engagement.
  - `totalNumbers` (integer, required, min 0). Specifies total numbers for this all of.
  - `measuredNumbers` (integer, required, min 0). Specifies measured numbers for this all of.
  - `connectedNumbers` (integer, required, min 0). Specifies connected numbers for this all of.
  - `messageAnalysis` (object, required). Structured message analysis values for this all of.
    - `complete` (boolean, required). Whether complete.
    - `segments` (array of object, required). Segments associated with this message analysi.
      - `dimension` (string, required). Specifies dimension for this segment. Values: `message_type`, `text_band`, `origin`, `calling_code`, `customer_devices`.
      - `key` (string, required). Specifies key for this segment.
      - `sendAttempts` (integer, required, min 0). Specifies send attempts for this segment.
      - `sent` (integer, required, min 0). Specifies sent for this segment.
      - `sendFailures` (integer, required, min 0). Specifies send failures for this segment.
      - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this segment.
      - `completedConversations` (integer, required, min 0). Specifies completed conversations for this segment.
      - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this segment.
      - `readConversations` (integer, required, min 0). Specifies read conversations for this segment.
      - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this segment.
      - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this segment.
      - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this segment.
      - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this segment.
      - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this segment.
      - `shareOfConversations` (number, required, nullable, range 0–1). Specifies share of conversations for this segment.
      - `shareOfSends` (number, required, nullable, range 0–1). Specifies share of sends for this segment.
      - `readRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
      - `replyRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
      - `readRateDifference` (number, required, nullable, range -1–1). Specifies read rate difference for this segment.
      - `replyRateDifference` (number, required, nullable, range -1–1). Specifies reply rate difference for this segment.
  - `customerActivity` (object, required). Structured customer activity values for this all of.
    - `observed` (boolean, required). Whether observed.
    - `onlineSignals` (integer, required, min 0). Specifies online signals for this customer activity.
    - `offlineSignals` (integer, required, min 0). Specifies offline signals for this customer activity.
    - `typingSignals` (integer, required, min 0). Specifies typing signals for this customer activity.
  - `accountActivity` (object, required). Structured account activity values for this all of.
    - `observed` (boolean, required). Whether observed.
    - `primaryPhoneActivitySignals` (integer, required, min 0). Specifies primary phone activity signals for this account activity.
    - `primaryPhoneActivePeriods` (integer, required, min 0). Specifies primary phone active periods for this account activity.
    - `completedPhoneActivityPeriods` (integer, required, min 0). Specifies completed phone activity periods for this account activity.
    - `phoneActivityMs` (integer, required, min 0). Specifies phone activity ms for this account activity.
    - `averagePhoneActivityMs` (number, required, nullable, min 0). Specifies average phone activity ms for this account activity.
    - `phoneQuietGaps` (integer, required, min 0). Specifies phone quiet gaps for this account activity.
    - `phoneQuietMs` (integer, required, min 0). Specifies phone quiet ms for this account activity.
    - `averagePhoneQuietMs` (number, required, nullable, min 0). Specifies average phone quiet ms for this account activity.
    - `primaryPhoneMessages` (integer, required, min 0). Specifies primary phone messages for this account activity.
    - `otherDeviceMessages` (integer, required, min 0). Specifies other device messages for this account activity.
    - `lastPrimaryPhoneAt` (integer, required, nullable). Unix milliseconds.
    - `primaryPhoneReplies` (integer, required, min 0). Specifies primary phone replies for this account activity.
    - `otherDeviceReplies` (integer, required, min 0). Specifies other device replies for this account activity.
    - `averagePrimaryPhoneResponseMs` (number, required, nullable, min 0). Specifies average primary phone response ms for this account activity.
    - `averageOtherDeviceResponseMs` (number, required, nullable, min 0). Specifies average other device response ms for this account activity.
  - `responseQueue` (object, required, nullable). Structured response queue values for this all of.
    - `awaitingReply` (integer, required, min 0). Specifies awaiting reply for this all of.
    - `oldestWaitingMs` (integer, required, min 0). Specifies oldest waiting ms for this all of.
    - `observedAt` (integer, required). Unix milliseconds.
    - `complete` (boolean, required). Whether complete.
  - `calls` (object, required). Structured calls values for this all of.
    - `total` (integer, required, min 0). Final total for this order or price summary.
    - `answered` (integer, required, min 0). Specifies answered for this call.
    - `missed` (integer, required, min 0). Specifies missed for this call.
    - `declined` (integer, required, min 0). Specifies declined for this call.
    - `failed` (integer, required, min 0). Specifies failed for this call.
    - `ringing` (integer, required, min 0). Specifies ringing for this call.
    - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this call.
    - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this call.
    - `timedAnswered` (integer, required, min 0). Specifies timed answered for this call.
    - `timedPickup` (integer, required, min 0). Specifies timed pickup for this call.
    - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this call.
    - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this call.
    - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this call.
    - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this call.
    - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this call.
    - `shortAnswered` (integer, required, min 0). Specifies short answered for this call.
    - `video` (integer, required, min 0). Specifies video for this call.
    - `directions` (object, required). Structured directions values for this call.
      - `inbound` (object, required). Structured inbound values for this direction.
        - `total` (integer, required, min 0). Final total for this order or price summary.
        - `answered` (integer, required, min 0). Specifies answered for this inbound.
        - `missed` (integer, required, min 0). Specifies missed for this inbound.
        - `declined` (integer, required, min 0). Specifies declined for this inbound.
        - `failed` (integer, required, min 0). Specifies failed for this inbound.
        - `ringing` (integer, required, min 0). Specifies ringing for this inbound.
        - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this inbound.
        - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this inbound.
        - `timedAnswered` (integer, required, min 0). Specifies timed answered for this inbound.
        - `timedPickup` (integer, required, min 0). Specifies timed pickup for this inbound.
        - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this inbound.
        - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this inbound.
        - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this inbound.
        - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this inbound.
        - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this inbound.
        - `shortAnswered` (integer, required, min 0). Specifies short answered for this inbound.
        - `video` (integer, required, min 0). Specifies video for this inbound.
      - `outbound` (object, required). Structured outbound values for this direction.
        - `total` (integer, required, min 0). Final total for this order or price summary.
        - `answered` (integer, required, min 0). Specifies answered for this outbound.
        - `missed` (integer, required, min 0). Specifies missed for this outbound.
        - `declined` (integer, required, min 0). Specifies declined for this outbound.
        - `failed` (integer, required, min 0). Specifies failed for this outbound.
        - `ringing` (integer, required, min 0). Specifies ringing for this outbound.
        - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this outbound.
        - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this outbound.
        - `timedAnswered` (integer, required, min 0). Specifies timed answered for this outbound.
        - `timedPickup` (integer, required, min 0). Specifies timed pickup for this outbound.
        - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this outbound.
        - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this outbound.
        - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this outbound.
        - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this outbound.
        - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this outbound.
        - `shortAnswered` (integer, required, min 0). Specifies short answered for this outbound.
        - `video` (integer, required, min 0). Specifies video for this outbound.
    - `mediaQuality` (object, required). Structured media quality values for this call.
      - `measuredCalls` (integer, required, min 0). Specifies measured calls for this media quality.
      - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this media quality.
      - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this media quality.
      - `packetsLost` (integer, required, nullable, min 0). Specifies packets lost for this media quality.
    - `appQuality` (object, required). Structured app quality values for this call.
      - `measuredCalls` (integer, required, min 0). Specifies measured calls for this app quality.
      - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this app quality.
      - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this app quality.
      - `packetLossRate` (number, required, nullable, range 0–1). Specifies packet loss rate for this app quality.
      - `reconnects` (integer, required, nullable, min 0). Specifies reconnects for this app quality.
    - `endReasons` (array of object, required). End reasons associated with this call.
      - `code` (string, required). Stable machine-readable code for this result.
      - `count` (integer, required, min 0). Number of matching resources.
    - `appErrors` (array of object, required). App errors associated with this call.
      - `code` (string, required). Stable machine-readable code for this result.
      - `count` (integer, required, min 0). Number of matching resources.
    - `transports` (array of object, required). Transports associated with this call.
      - `code` (string, required). Stable machine-readable code for this result.
      - `count` (integer, required, min 0). Number of matching resources.
    - `multiParticipantCalls` (integer, required, min 0). Specifies multi participant calls for this call.
    - `followUp` (object, required). Structured follow up values for this call.
      - `eligibleMissed` (integer, required, min 0). Specifies eligible missed for this follow up.
      - `returnedWithin24h` (integer, required, min 0). Specifies returned within24h for this follow up.
      - `rate` (number, required, nullable, range 0–1). Specifies rate for this follow up.
      - `averageDelayMs` (number, required, nullable, min 0). Specifies average delay ms for this follow up.
      - `pendingWindow` (integer, required, min 0). Specifies pending window for this follow up.
      - `unknownContact` (integer, required, min 0). Specifies unknown contact for this follow up.
  - `deviceAnalytics` (object, required). Observed message client-family distributions and a bounded inventory of this number's own devices. The combined summary has null inventory.
    - `detector` (string, required). Specifies detector for this device analytic. Values: `message_id_prefix/v1`.
    - `measured` (boolean, required). True when at least one retained bucket has client-family measurement coverage, including buckets with zero messages.
    - `complete` (boolean, required). True when measured is true, every retained bucket has device-family coverage and conversation receipt coverage is complete. False when coverage is missing or records, conversations or receipt joins were dropped. Inventory truncation is reported separately.
    - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this device analytic.
    - `customerMessages` (integer, required, nullable, min 0). Specifies customer messages for this device analytic.
    - `accountMessages` (integer, required, nullable, min 0). Specifies account messages for this device analytic.
    - `customerPlatforms` (array of object, required). Customer platforms associated with this device analytic.
      - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
      - `messages` (integer, required, min 0). Specifies messages for this customer platform.
      - `share` (number, required, nullable, range 0–1). Specifies share for this customer platform.
    - `accountPlatforms` (array of object, required). Account platforms associated with this device analytic.
      - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
      - `messages` (integer, required, min 0). Specifies messages for this account platform.
      - `share` (number, required, nullable, range 0–1). Specifies share for this account platform.
    - `inventory` (object, required, nullable). Structured inventory values for this device analytic.
      - `listObserved` (boolean, required). True after a full device list for this number was observed.
      - `listCurrent` (boolean, required). True when a full list was observed and no later list-change signal invalidated it. Membership and device count are unknown until another full list after a change.
      - `observedAt` (integer, required, nullable). Unix milliseconds.
      - `deviceCount` (integer, required, nullable, min 0). Number of devices.
      - `truncated` (boolean, required). True when the bounded inventory omitted devices. At most 25 device rows are returned; a current full-list device count can be larger.
      - `devices` (array of object, required, max items 25). Devices associated with this inventory.
        - `deviceIndex` (integer, required, range 0–999). Specifies device index for this device.
        - `estimatedPlatform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `reportedClass` (string, required). Specifies reported class for this device. Values: `phone`, `desktop_app`, `browser`, `business_api`, `unknown` (No recognized reported device class.).
        - `lastActiveAt` (integer, required, nullable). Unix milliseconds.
        - `listed` (boolean, required, nullable). Whether this device index belongs to the latest observed full list. Null when that list is no longer current.
  - `conversationBreakdown` (object, required). Completed 24-hour conversation cohorts grouped jointly by completion bucket, first outgoing message metadata, calling code and observed device-count class.
    - `measured` (boolean, required). True when at least one retained bucket includes joint conversation categories.
    - `complete` (boolean, required). True when measured is true, every retained bucket has joint conversation coverage, no conversation, record or receipt-join coverage was lost and the returned groups are not truncated. Rates and averages are null when false.
    - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this conversation breakdown.
    - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this conversation breakdown.
    - `truncated` (boolean, required). True when the requested scope exceeded 4096 number/time/category groups. The largest groups are retained; rates and averages are null.
    - `buckets` (array of object, required). Buckets associated with this conversation breakdown.
      - `ts` (integer, required). Unix milliseconds.
      - `complete` (boolean, required). True when this UTC time bucket has joint category coverage and no conversations or records were dropped. A summary bucket also requires every scoped number to have a bucket.
    - `rows` (array of object, required, max items 4096). Rows associated with this conversation breakdown.
      - `ts` (integer, required). Unix milliseconds.
      - `messageType` (string, required). Category assigned to message. Values: `text`, `image`, `video`, `audio`, `document`, `sticker`, `interactive`, `template`, `other`.
      - `textBand` (string, required). Specifies text band for this row. Values: `none`, `short`, `medium`, `long`, `very_long`, `unknown`.
      - `origin` (string, required). Specifies origin for this row. Values: `api` (API send.), `campaign` (Campaign send.), `other` (Other or unclassified send source.).
      - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Numbering country inferred from a full phone number or valid BSUID prefix; Unknown for missing historical metadata. Not current location.
      - `recipientDeviceCount` (string, required). Observed linked-device range; device zero is the primary and is excluded from linked counts. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
      - `callingCode` (string, required, pattern ^(unknown|[1-9][0-9]{0,2})$). Machine-readable calling code for this row.
      - `customerDevices` (string, required). Specifies customer devices for this row. Values: `single`, `multiple`, `unknown`.
      - `completedConversations` (integer, required, min 0). Specifies completed conversations for this row.
      - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this row.
      - `readConversations` (integer, required, min 0). Specifies read conversations for this row.
      - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this row.
      - `replyLatencySumMs` (integer, required, min 0). Specifies reply latency sum ms for this row.
      - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this row.
      - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this row.
      - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this row.
  - `recipientActivity` (object). Hourly aggregate recipient observations, grouped jointly by numbering country, observed linked-device count and sender-device class. Incoming messages and matched delivery/read receipts are deduplicated by native message and device in bounded memory. Presence is user-level and uses Unknown device source. Quiet gaps of at least 15 minutes are completed gaps between observed signals on the same device, never verified offline periods. No recipient identity, native message ID or recipient device index is retained. Coverage is explicit; older retained buckets are unmeasured. Message telemetry remains Linked Devices only; Official API message activity is not measured.
    - `measured` (boolean, required). Whether measured.
    - `complete` (boolean, required). Whether complete.
    - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this recipient activity.
    - `droppedSignals` (integer, required, min 0). Specifies dropped signals for this recipient activity.
    - `truncated` (boolean, required). Whether truncated.
    - `rows` (array of object, required, max items 4096). Rows associated with this recipient activity.
      - `ts` (integer, required). Unix milliseconds.
      - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Specifies recipient country for this row.
      - `recipientDeviceCount` (string, required). Number of recipient devices. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
      - `deviceSource` (string, required). Specifies device source for this row. Values: `primary`, `linked`, `unknown`.
      - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this row.
      - `deliveryReceipts` (integer, required, min 0). Specifies delivery receipts for this row.
      - `readReceipts` (integer, required, min 0). Specifies read receipts for this row.
      - `onlineSignals` (integer, required, min 0). Specifies online signals for this row.
      - `offlineSignals` (integer, required, min 0). Specifies offline signals for this row.
      - `typingSignals` (integer, required, min 0). Specifies typing signals for this row.
      - `lastSignalAt` (integer, required). Unix milliseconds.
      - `quietGaps` (integer, required, min 0). Specifies quiet gaps for this row.
      - `quietGapMs` (integer, required, min 0). Specifies quiet gap ms for this row.
      - `averageQuietGapMs` (number, required, nullable, min 0). Specifies average quiet gap ms for this row.
- `numbers` (array of object, required). Numbers associated with this management whats app analytic.
  - `sessionId` (string (uuid), required, format uuid). Identifier of the connected Polymorfa session.
  - `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
  - `name` (string, required). Human-readable name for this resource.
  - `backend` (string, required). Specifies backend for this number.
  - `status` (string, required). Current status of this resource or operation.
  - `measured` (boolean, required). Whether measured.
  - `observedHours` (integer, required, min 0). Specifies observed hours for this number.
  - `lastObservedAt` (integer, required, nullable). Unix milliseconds.
  - `outgoingMessages` (integer, required, min 0). Specifies outgoing messages for this number.
  - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this number.
  - `sendAttempts` (integer, required, min 0). Specifies send attempts for this number.
  - `sendFailures` (integer, required, min 0). Specifies send failures for this number.
  - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this number.
  - `businessReplies` (integer, required, min 0). Specifies business replies for this number.
  - `averageBusinessResponseMs` (number, required, nullable, min 0). Specifies average business response ms for this number.
  - `onlineMs` (integer, required, min 0). Specifies online ms for this number.
  - `disconnects` (integer, required, min 0). Specifies disconnects for this number.
  - `connectFailures` (integer, required, min 0). Specifies connect failures for this number.
  - `streamErrors` (integer, required, min 0). Specifies stream errors for this number.
  - `keepaliveTimeouts` (integer, required, min 0). Specifies keepalive timeouts for this number.
  - `engagement` (object, required). Structured engagement values for this number.
    - `windowHours` (integer, required). Specifies window hours for this engagement. Values: `24`.
    - `completedConversations` (integer, required, min 0). Specifies completed conversations for this engagement.
    - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this engagement.
    - `readConversations` (integer, required, min 0). Specifies read conversations for this engagement.
    - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this engagement.
    - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this engagement.
    - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this engagement.
    - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this engagement.
    - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this engagement.
    - `complete` (boolean, required). Whether complete.
    - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this engagement.
    - `droppedRecords` (integer, required, min 0). Specifies dropped records for this engagement.
    - `droppedReceiptJoins` (integer, required, min 0). Specifies dropped receipt joins for this engagement.
  - `messageAnalysis` (object, required). Structured message analysis values for this number.
    - `complete` (boolean, required). Whether complete.
    - `segments` (array of object, required). Segments associated with this message analysi.
      - `dimension` (string, required). Specifies dimension for this segment. Values: `message_type`, `text_band`, `origin`, `calling_code`, `customer_devices`.
      - `key` (string, required). Specifies key for this segment.
      - `sendAttempts` (integer, required, min 0). Specifies send attempts for this segment.
      - `sent` (integer, required, min 0). Specifies sent for this segment.
      - `sendFailures` (integer, required, min 0). Specifies send failures for this segment.
      - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this segment.
      - `completedConversations` (integer, required, min 0). Specifies completed conversations for this segment.
      - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this segment.
      - `readConversations` (integer, required, min 0). Specifies read conversations for this segment.
      - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this segment.
      - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this segment.
      - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this segment.
      - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this segment.
      - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this segment.
      - `shareOfConversations` (number, required, nullable, range 0–1). Specifies share of conversations for this segment.
      - `shareOfSends` (number, required, nullable, range 0–1). Specifies share of sends for this segment.
      - `readRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
      - `replyRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
      - `readRateDifference` (number, required, nullable, range -1–1). Specifies read rate difference for this segment.
      - `replyRateDifference` (number, required, nullable, range -1–1). Specifies reply rate difference for this segment.
  - `customerActivity` (object, required). Structured customer activity values for this number.
    - `observed` (boolean, required). Whether observed.
    - `onlineSignals` (integer, required, min 0). Specifies online signals for this customer activity.
    - `offlineSignals` (integer, required, min 0). Specifies offline signals for this customer activity.
    - `typingSignals` (integer, required, min 0). Specifies typing signals for this customer activity.
  - `accountActivity` (object, required). Structured account activity values for this number.
    - `observed` (boolean, required). Whether observed.
    - `primaryPhoneActivitySignals` (integer, required, min 0). Specifies primary phone activity signals for this account activity.
    - `primaryPhoneActivePeriods` (integer, required, min 0). Specifies primary phone active periods for this account activity.
    - `completedPhoneActivityPeriods` (integer, required, min 0). Specifies completed phone activity periods for this account activity.
    - `phoneActivityMs` (integer, required, min 0). Specifies phone activity ms for this account activity.
    - `averagePhoneActivityMs` (number, required, nullable, min 0). Specifies average phone activity ms for this account activity.
    - `phoneQuietGaps` (integer, required, min 0). Specifies phone quiet gaps for this account activity.
    - `phoneQuietMs` (integer, required, min 0). Specifies phone quiet ms for this account activity.
    - `averagePhoneQuietMs` (number, required, nullable, min 0). Specifies average phone quiet ms for this account activity.
    - `primaryPhoneMessages` (integer, required, min 0). Specifies primary phone messages for this account activity.
    - `otherDeviceMessages` (integer, required, min 0). Specifies other device messages for this account activity.
    - `lastPrimaryPhoneAt` (integer, required, nullable). Unix milliseconds.
    - `primaryPhoneReplies` (integer, required, min 0). Specifies primary phone replies for this account activity.
    - `otherDeviceReplies` (integer, required, min 0). Specifies other device replies for this account activity.
    - `averagePrimaryPhoneResponseMs` (number, required, nullable, min 0). Specifies average primary phone response ms for this account activity.
    - `averageOtherDeviceResponseMs` (number, required, nullable, min 0). Specifies average other device response ms for this account activity.
  - `responseQueue` (object, required, nullable). Structured response queue values for this number.
    - `awaitingReply` (integer, required, min 0). Specifies awaiting reply for this all of.
    - `oldestWaitingMs` (integer, required, min 0). Specifies oldest waiting ms for this all of.
    - `observedAt` (integer, required). Unix milliseconds.
    - `complete` (boolean, required). Whether complete.
  - `projectName` (string, required). Human-readable project name for this number.
  - `calls` (object, required). Structured calls values for this number.
    - `total` (integer, required, min 0). Final total for this order or price summary.
    - `answered` (integer, required, min 0). Specifies answered for this call.
    - `missed` (integer, required, min 0). Specifies missed for this call.
    - `declined` (integer, required, min 0). Specifies declined for this call.
    - `failed` (integer, required, min 0). Specifies failed for this call.
    - `ringing` (integer, required, min 0). Specifies ringing for this call.
    - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this call.
    - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this call.
    - `timedAnswered` (integer, required, min 0). Specifies timed answered for this call.
    - `timedPickup` (integer, required, min 0). Specifies timed pickup for this call.
    - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this call.
    - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this call.
    - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this call.
    - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this call.
    - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this call.
    - `shortAnswered` (integer, required, min 0). Specifies short answered for this call.
    - `video` (integer, required, min 0). Specifies video for this call.
    - `directions` (object, required). Structured directions values for this call.
      - `inbound` (object, required). Structured inbound values for this direction.
        - `total` (integer, required, min 0). Final total for this order or price summary.
        - `answered` (integer, required, min 0). Specifies answered for this inbound.
        - `missed` (integer, required, min 0). Specifies missed for this inbound.
        - `declined` (integer, required, min 0). Specifies declined for this inbound.
        - `failed` (integer, required, min 0). Specifies failed for this inbound.
        - `ringing` (integer, required, min 0). Specifies ringing for this inbound.
        - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this inbound.
        - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this inbound.
        - `timedAnswered` (integer, required, min 0). Specifies timed answered for this inbound.
        - `timedPickup` (integer, required, min 0). Specifies timed pickup for this inbound.
        - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this inbound.
        - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this inbound.
        - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this inbound.
        - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this inbound.
        - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this inbound.
        - `shortAnswered` (integer, required, min 0). Specifies short answered for this inbound.
        - `video` (integer, required, min 0). Specifies video for this inbound.
      - `outbound` (object, required). Structured outbound values for this direction.
        - `total` (integer, required, min 0). Final total for this order or price summary.
        - `answered` (integer, required, min 0). Specifies answered for this outbound.
        - `missed` (integer, required, min 0). Specifies missed for this outbound.
        - `declined` (integer, required, min 0). Specifies declined for this outbound.
        - `failed` (integer, required, min 0). Specifies failed for this outbound.
        - `ringing` (integer, required, min 0). Specifies ringing for this outbound.
        - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this outbound.
        - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this outbound.
        - `timedAnswered` (integer, required, min 0). Specifies timed answered for this outbound.
        - `timedPickup` (integer, required, min 0). Specifies timed pickup for this outbound.
        - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this outbound.
        - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this outbound.
        - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this outbound.
        - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this outbound.
        - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this outbound.
        - `shortAnswered` (integer, required, min 0). Specifies short answered for this outbound.
        - `video` (integer, required, min 0). Specifies video for this outbound.
    - `mediaQuality` (object, required). Structured media quality values for this call.
      - `measuredCalls` (integer, required, min 0). Specifies measured calls for this media quality.
      - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this media quality.
      - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this media quality.
      - `packetsLost` (integer, required, nullable, min 0). Specifies packets lost for this media quality.
    - `appQuality` (object, required). Structured app quality values for this call.
      - `measuredCalls` (integer, required, min 0). Specifies measured calls for this app quality.
      - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this app quality.
      - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this app quality.
      - `packetLossRate` (number, required, nullable, range 0–1). Specifies packet loss rate for this app quality.
      - `reconnects` (integer, required, nullable, min 0). Specifies reconnects for this app quality.
    - `endReasons` (array of object, required). End reasons associated with this call.
      - `code` (string, required). Stable machine-readable code for this result.
      - `count` (integer, required, min 0). Number of matching resources.
    - `appErrors` (array of object, required). App errors associated with this call.
      - `code` (string, required). Stable machine-readable code for this result.
      - `count` (integer, required, min 0). Number of matching resources.
    - `transports` (array of object, required). Transports associated with this call.
      - `code` (string, required). Stable machine-readable code for this result.
      - `count` (integer, required, min 0). Number of matching resources.
    - `multiParticipantCalls` (integer, required, min 0). Specifies multi participant calls for this call.
    - `followUp` (object, required). Structured follow up values for this call.
      - `eligibleMissed` (integer, required, min 0). Specifies eligible missed for this follow up.
      - `returnedWithin24h` (integer, required, min 0). Specifies returned within24h for this follow up.
      - `rate` (number, required, nullable, range 0–1). Specifies rate for this follow up.
      - `averageDelayMs` (number, required, nullable, min 0). Specifies average delay ms for this follow up.
      - `pendingWindow` (integer, required, min 0). Specifies pending window for this follow up.
      - `unknownContact` (integer, required, min 0). Specifies unknown contact for this follow up.
  - `deviceAnalytics` (object, required). Observed message client-family distributions and a bounded inventory of this number's own devices. The combined summary has null inventory.
    - `detector` (string, required). Specifies detector for this device analytic. Values: `message_id_prefix/v1`.
    - `measured` (boolean, required). True when at least one retained bucket has client-family measurement coverage, including buckets with zero messages.
    - `complete` (boolean, required). True when measured is true, every retained bucket has device-family coverage and conversation receipt coverage is complete. False when coverage is missing or records, conversations or receipt joins were dropped. Inventory truncation is reported separately.
    - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this device analytic.
    - `customerMessages` (integer, required, nullable, min 0). Specifies customer messages for this device analytic.
    - `accountMessages` (integer, required, nullable, min 0). Specifies account messages for this device analytic.
    - `customerPlatforms` (array of object, required). Customer platforms associated with this device analytic.
      - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
      - `messages` (integer, required, min 0). Specifies messages for this customer platform.
      - `share` (number, required, nullable, range 0–1). Specifies share for this customer platform.
    - `accountPlatforms` (array of object, required). Account platforms associated with this device analytic.
      - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
      - `messages` (integer, required, min 0). Specifies messages for this account platform.
      - `share` (number, required, nullable, range 0–1). Specifies share for this account platform.
    - `inventory` (object, required, nullable). Structured inventory values for this device analytic.
      - `listObserved` (boolean, required). True after a full device list for this number was observed.
      - `listCurrent` (boolean, required). True when a full list was observed and no later list-change signal invalidated it. Membership and device count are unknown until another full list after a change.
      - `observedAt` (integer, required, nullable). Unix milliseconds.
      - `deviceCount` (integer, required, nullable, min 0). Number of devices.
      - `truncated` (boolean, required). True when the bounded inventory omitted devices. At most 25 device rows are returned; a current full-list device count can be larger.
      - `devices` (array of object, required, max items 25). Devices associated with this inventory.
        - `deviceIndex` (integer, required, range 0–999). Specifies device index for this device.
        - `estimatedPlatform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `reportedClass` (string, required). Specifies reported class for this device. Values: `phone`, `desktop_app`, `browser`, `business_api`, `unknown` (No recognized reported device class.).
        - `lastActiveAt` (integer, required, nullable). Unix milliseconds.
        - `listed` (boolean, required, nullable). Whether this device index belongs to the latest observed full list. Null when that list is no longer current.
  - `conversationBreakdown` (object, required). Completed 24-hour conversation cohorts grouped jointly by completion bucket, first outgoing message metadata, calling code and observed device-count class.
    - `measured` (boolean, required). True when at least one retained bucket includes joint conversation categories.
    - `complete` (boolean, required). True when measured is true, every retained bucket has joint conversation coverage, no conversation, record or receipt-join coverage was lost and the returned groups are not truncated. Rates and averages are null when false.
    - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this conversation breakdown.
    - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this conversation breakdown.
    - `truncated` (boolean, required). True when the requested scope exceeded 4096 number/time/category groups. The largest groups are retained; rates and averages are null.
    - `buckets` (array of object, required). Buckets associated with this conversation breakdown.
      - `ts` (integer, required). Unix milliseconds.
      - `complete` (boolean, required). True when this UTC time bucket has joint category coverage and no conversations or records were dropped. A summary bucket also requires every scoped number to have a bucket.
    - `rows` (array of object, required, max items 4096). Rows associated with this conversation breakdown.
      - `ts` (integer, required). Unix milliseconds.
      - `messageType` (string, required). Category assigned to message. Values: `text`, `image`, `video`, `audio`, `document`, `sticker`, `interactive`, `template`, `other`.
      - `textBand` (string, required). Specifies text band for this row. Values: `none`, `short`, `medium`, `long`, `very_long`, `unknown`.
      - `origin` (string, required). Specifies origin for this row. Values: `api` (API send.), `campaign` (Campaign send.), `other` (Other or unclassified send source.).
      - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Numbering country inferred from a full phone number or valid BSUID prefix; Unknown for missing historical metadata. Not current location.
      - `recipientDeviceCount` (string, required). Observed linked-device range; device zero is the primary and is excluded from linked counts. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
      - `callingCode` (string, required, pattern ^(unknown|[1-9][0-9]{0,2})$). Machine-readable calling code for this row.
      - `customerDevices` (string, required). Specifies customer devices for this row. Values: `single`, `multiple`, `unknown`.
      - `completedConversations` (integer, required, min 0). Specifies completed conversations for this row.
      - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this row.
      - `readConversations` (integer, required, min 0). Specifies read conversations for this row.
      - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this row.
      - `replyLatencySumMs` (integer, required, min 0). Specifies reply latency sum ms for this row.
      - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this row.
      - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this row.
      - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this row.
  - `recipientActivity` (object). Hourly aggregate recipient observations, grouped jointly by numbering country, observed linked-device count and sender-device class. Incoming messages and matched delivery/read receipts are deduplicated by native message and device in bounded memory. Presence is user-level and uses Unknown device source. Quiet gaps of at least 15 minutes are completed gaps between observed signals on the same device, never verified offline periods. No recipient identity, native message ID or recipient device index is retained. Coverage is explicit; older retained buckets are unmeasured. Message telemetry remains Linked Devices only; Official API message activity is not measured.
    - `measured` (boolean, required). Whether measured.
    - `complete` (boolean, required). Whether complete.
    - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this recipient activity.
    - `droppedSignals` (integer, required, min 0). Specifies dropped signals for this recipient activity.
    - `truncated` (boolean, required). Whether truncated.
    - `rows` (array of object, required, max items 4096). Rows associated with this recipient activity.
      - `ts` (integer, required). Unix milliseconds.
      - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Specifies recipient country for this row.
      - `recipientDeviceCount` (string, required). Number of recipient devices. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
      - `deviceSource` (string, required). Specifies device source for this row. Values: `primary`, `linked`, `unknown`.
      - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this row.
      - `deliveryReceipts` (integer, required, min 0). Specifies delivery receipts for this row.
      - `readReceipts` (integer, required, min 0). Specifies read receipts for this row.
      - `onlineSignals` (integer, required, min 0). Specifies online signals for this row.
      - `offlineSignals` (integer, required, min 0). Specifies offline signals for this row.
      - `typingSignals` (integer, required, min 0). Specifies typing signals for this row.
      - `lastSignalAt` (integer, required). Unix milliseconds.
      - `quietGaps` (integer, required, min 0). Specifies quiet gaps for this row.
      - `quietGapMs` (integer, required, min 0). Specifies quiet gap ms for this row.
      - `averageQuietGapMs` (number, required, nullable, min 0). Specifies average quiet gap ms for this row.
- `series` (array of object, required). Series associated with this management whats app analytic.
  - `ts` (integer, required). Unix milliseconds.
  - `outgoingMessages` (integer, required, min 0). Specifies outgoing messages for this sery.
  - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this sery.
  - `sendFailures` (integer, required, min 0). Specifies send failures for this sery.
  - `businessReplies` (integer, required, min 0). Specifies business replies for this sery.
  - `averageBusinessResponseMs` (number, required, nullable, min 0). Specifies average business response ms for this sery.
  - `onlineMs` (integer, required, min 0). Specifies online ms for this sery.
  - `disconnects` (integer, required, min 0). Specifies disconnects for this sery.
  - `sessionId` (string (uuid), required, format uuid). Identifier of the connected Polymorfa session.
  - `customerOnlineSignals` (integer, required, min 0). Specifies customer online signals for this sery.
  - `customerTypingSignals` (integer, required, min 0). Specifies customer typing signals for this sery.
  - `primaryPhoneMessages` (integer, required, min 0). Specifies primary phone messages for this sery.
  - `otherDeviceMessages` (integer, required, min 0). Specifies other device messages for this sery.
  - `primaryPhoneReplies` (integer, required, min 0). Specifies primary phone replies for this sery.
  - `phoneActivePeriods` (integer, required, min 0). Specifies phone active periods for this sery.
  - `completedPhoneActivityPeriods` (integer, required, min 0). Specifies completed phone activity periods for this sery.
  - `phoneActivityMs` (integer, required, min 0). Specifies phone activity ms for this sery.
  - `phoneQuietGaps` (integer, required, min 0). Specifies phone quiet gaps for this sery.
  - `phoneQuietMs` (integer, required, min 0). Specifies phone quiet ms for this sery.
- `callSeries` (array of object, required). Call series associated with this management whats app analytic.
  - `total` (integer, required, min 0). Final total for this order or price summary.
  - `answered` (integer, required, min 0). Specifies answered for this call sery.
  - `missed` (integer, required, min 0). Specifies missed for this call sery.
  - `declined` (integer, required, min 0). Specifies declined for this call sery.
  - `failed` (integer, required, min 0). Specifies failed for this call sery.
  - `ringing` (integer, required, min 0). Specifies ringing for this call sery.
  - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this call sery.
  - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this call sery.
  - `timedAnswered` (integer, required, min 0). Specifies timed answered for this call sery.
  - `timedPickup` (integer, required, min 0). Specifies timed pickup for this call sery.
  - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this call sery.
  - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this call sery.
  - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this call sery.
  - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this call sery.
  - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this call sery.
  - `shortAnswered` (integer, required, min 0). Specifies short answered for this call sery.
  - `video` (integer, required, min 0). Specifies video for this call sery.
  - `sessionId` (string (uuid), required, format uuid). Identifier of the connected Polymorfa session.
  - `ts` (integer, required). Unix milliseconds.
```json
{
  "enabled": true,
  "period": {
    "start": 0,
    "end": 0
  },
  "requestVitals": {
    "requests": 0,
    "failures": 0,
    "errorRate": 0
  },
  "summary": {
    "measured": true,
    "observedHours": 0,
    "lastObservedAt": 0,
    "outgoingMessages": 0,
    "incomingMessages": 0,
    "sendAttempts": 0,
    "sendFailures": 0,
    "sendFailureRate": 0,
    "businessReplies": 0,
    "averageBusinessResponseMs": 0,
    "onlineMs": 0,
    "disconnects": 0,
    "connectFailures": 0,
    "streamErrors": 0,
    "keepaliveTimeouts": 0,
    "engagement": {
      "windowHours": 24,
      "completedConversations": 0,
      "deliveredConversations": 0,
      "readConversations": 0,
      "repliedConversations": 0,
      "deliveryRate": 0,
      "readRate": 0,
      "replyRate": 0,
      "averageCustomerReplyMs": 0,
      "complete": true,
      "droppedConversations": 0,
      "droppedRecords": 0,
      "droppedReceiptJoins": 0
    },
    "totalNumbers": 0,
    "measuredNumbers": 0,
    "connectedNumbers": 0,
    "messageAnalysis": {
      "complete": true,
      "segments": [
        {
          "dimension": "message_type",
          "key": "string",
          "sendAttempts": 0,
          "sent": 0,
          "sendFailures": 0,
          "sendFailureRate": 0,
          "completedConversations": 0,
          "deliveredConversations": 0,
          "readConversations": 0,
          "repliedConversations": 0,
          "deliveryRate": 0,
          "readRate": 0,
          "replyRate": 0,
          "averageCustomerReplyMs": 0,
          "shareOfConversations": 0,
          "shareOfSends": 0,
          "readRateInterval95": [
            0
          ],
          "replyRateInterval95": [
            0
          ],
          "readRateDifference": -1,
          "replyRateDifference": -1
        }
      ]
    },
    "customerActivity": {
      "observed": true,
      "onlineSignals": 0,
      "offlineSignals": 0,
      "typingSignals": 0
    },
    "accountActivity": {
      "observed": true,
      "primaryPhoneActivitySignals": 0,
      "primaryPhoneActivePeriods": 0,
      "completedPhoneActivityPeriods": 0,
      "phoneActivityMs": 0,
      "averagePhoneActivityMs": 0,
      "phoneQuietGaps": 0,
      "phoneQuietMs": 0,
      "averagePhoneQuietMs": 0,
      "primaryPhoneMessages": 0,
      "otherDeviceMessages": 0,
      "lastPrimaryPhoneAt": 0,
      "primaryPhoneReplies": 0,
      "otherDeviceReplies": 0,
      "averagePrimaryPhoneResponseMs": 0,
      "averageOtherDeviceResponseMs": 0
    },
    "responseQueue": {
      "awaitingReply": 0,
      "oldestWaitingMs": 0,
      "observedAt": 0,
      "complete": true
    },
    "calls": {
      "total": 0,
      "answered": 0,
      "missed": 0,
      "declined": 0,
      "failed": 0,
      "ringing": 0,
      "answerRate": 0,
      "talkSeconds": 0,
      "timedAnswered": 0,
      "timedPickup": 0,
      "averageTalkSeconds": 0,
      "medianTalkSeconds": 0,
      "p95TalkSeconds": 0,
      "averagePickupMs": 0,
      "p95PickupMs": 0,
      "shortAnswered": 0,
      "video": 0,
      "directions": {
        "inbound": {
          "total": 0,
          "answered": 0,
          "missed": 0,
          "declined": 0,
          "failed": 0,
          "ringing": 0,
          "answerRate": 0,
          "talkSeconds": 0,
          "timedAnswered": 0,
          "timedPickup": 0,
          "averageTalkSeconds": 0,
          "medianTalkSeconds": 0,
          "p95TalkSeconds": 0,
          "averagePickupMs": 0,
          "p95PickupMs": 0,
          "shortAnswered": 0,
          "video": 0
        },
        "outbound": {
          "total": 0,
          "answered": 0,
          "missed": 0,
          "declined": 0,
          "failed": 0,
          "ringing": 0,
          "answerRate": 0,
          "talkSeconds": 0,
          "timedAnswered": 0,
          "timedPickup": 0,
          "averageTalkSeconds": 0,
          "medianTalkSeconds": 0,
          "p95TalkSeconds": 0,
          "averagePickupMs": 0,
          "p95PickupMs": 0,
          "shortAnswered": 0,
          "video": 0
        }
      },
      "mediaQuality": {
        "measuredCalls": 0,
        "averageJitterMs": 0,
        "averageRttMs": 0,
        "packetsLost": 0
      },
      "appQuality": {
        "measuredCalls": 0,
        "averageJitterMs": 0,
        "averageRttMs": 0,
        "packetLossRate": 0,
        "reconnects": 0
      },
      "endReasons": [
        {
          "code": "string",
          "count": 0
        }
      ],
      "appErrors": [
        {
          "code": "string",
          "count": 0
        }
      ],
      "transports": [
        {
          "code": "string",
          "count": 0
        }
      ],
      "multiParticipantCalls": 0,
      "followUp": {
        "eligibleMissed": 0,
        "returnedWithin24h": 0,
        "rate": 0,
        "averageDelayMs": 0,
        "pendingWindow": 0,
        "unknownContact": 0
      }
    },
    "deviceAnalytics": {
      "detector": "message_id_prefix/v1",
      "measured": true,
      "complete": true,
      "observedBuckets": 0,
      "customerMessages": 0,
      "accountMessages": 0,
      "customerPlatforms": [
        {
          "platform": "web",
          "messages": 0,
          "share": 0
        }
      ],
      "accountPlatforms": [
        {
          "platform": "web",
          "messages": 0,
          "share": 0
        }
      ],
      "inventory": {
        "listObserved": true,
        "listCurrent": true,
        "observedAt": 0,
        "deviceCount": 0,
        "truncated": true,
        "devices": [
          {
            "deviceIndex": 0,
            "estimatedPlatform": "web",
            "reportedClass": "phone",
            "lastActiveAt": 0,
            "listed": true
          }
        ]
      }
    },
    "conversationBreakdown": {
      "measured": true,
      "complete": true,
      "observedBuckets": 0,
      "droppedConversations": 0,
      "truncated": true,
      "buckets": [
        {
          "ts": 0,
          "complete": true
        }
      ],
      "rows": [
        {
          "ts": 0,
          "messageType": "text",
          "textBand": "none",
          "origin": "api",
          "recipientCountry": "string",
          "recipientDeviceCount": "primary_only",
          "callingCode": "string",
          "customerDevices": "single",
          "completedConversations": 0,
          "deliveredConversations": 0,
          "readConversations": 0,
          "repliedConversations": 0,
          "replyLatencySumMs": 0,
          "readRate": 0,
          "replyRate": 0,
          "averageCustomerReplyMs": 0
        }
      ]
    },
    "recipientActivity": {
      "measured": true,
      "complete": true,
      "observedBuckets": 0,
      "droppedSignals": 0,
      "truncated": true,
      "rows": [
        {
          "ts": 0,
          "recipientCountry": "string",
          "recipientDeviceCount": "primary_only",
          "deviceSource": "primary",
          "incomingMessages": 0,
          "deliveryReceipts": 0,
          "readReceipts": 0,
          "onlineSignals": 0,
          "offlineSignals": 0,
          "typingSignals": 0,
          "lastSignalAt": 0,
          "quietGaps": 0,
          "quietGapMs": 0,
          "averageQuietGapMs": 0
        }
      ]
    }
  },
  "numbers": [
    {
      "sessionId": "00000000-0000-4000-8000-000000000000",
      "projectId": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "backend": "string",
      "status": "string",
      "measured": true,
      "observedHours": 0,
      "lastObservedAt": 0,
      "outgoingMessages": 0,
      "incomingMessages": 0,
      "sendAttempts": 0,
      "sendFailures": 0,
      "sendFailureRate": 0,
      "businessReplies": 0,
      "averageBusinessResponseMs": 0,
      "onlineMs": 0,
      "disconnects": 0,
      "connectFailures": 0,
      "streamErrors": 0,
      "keepaliveTimeouts": 0,
      "engagement": {
        "windowHours": 24,
        "completedConversations": 0,
        "deliveredConversations": 0,
        "readConversations": 0,
        "repliedConversations": 0,
        "deliveryRate": 0,
        "readRate": 0,
        "replyRate": 0,
        "averageCustomerReplyMs": 0,
        "complete": true,
        "droppedConversations": 0,
        "droppedRecords": 0,
        "droppedReceiptJoins": 0
      },
      "messageAnalysis": {
        "complete": true,
        "segments": [
          {
            "dimension": "message_type",
            "key": "string",
            "sendAttempts": 0,
            "sent": 0,
            "sendFailures": 0,
            "sendFailureRate": 0,
            "completedConversations": 0,
            "deliveredConversations": 0,
            "readConversations": 0,
            "repliedConversations": 0,
            "deliveryRate": 0,
            "readRate": 0,
            "replyRate": 0,
            "averageCustomerReplyMs": 0,
            "shareOfConversations": 0,
            "shareOfSends": 0,
            "readRateInterval95": [
              null
            ],
            "replyRateInterval95": [
              null
            ],
            "readRateDifference": -1,
            "replyRateDifference": -1
          }
        ]
      },
      "customerActivity": {
        "observed": true,
        "onlineSignals": 0,
        "offlineSignals": 0,
        "typingSignals": 0
      },
      "accountActivity": {
        "observed": true,
        "primaryPhoneActivitySignals": 0,
        "primaryPhoneActivePeriods": 0,
        "completedPhoneActivityPeriods": 0,
        "phoneActivityMs": 0,
        "averagePhoneActivityMs": 0,
        "phoneQuietGaps": 0,
        "phoneQuietMs": 0,
        "averagePhoneQuietMs": 0,
        "primaryPhoneMessages": 0,
        "otherDeviceMessages": 0,
        "lastPrimaryPhoneAt": 0,
        "primaryPhoneReplies": 0,
        "otherDeviceReplies": 0,
        "averagePrimaryPhoneResponseMs": 0,
        "averageOtherDeviceResponseMs": 0
      },
      "responseQueue": {
        "awaitingReply": 0,
        "oldestWaitingMs": 0,
        "observedAt": 0,
        "complete": true
      },
      "projectName": "string",
      "calls": {
        "total": 0,
        "answered": 0,
        "missed": 0,
        "declined": 0,
        "failed": 0,
        "ringing": 0,
        "answerRate": 0,
        "talkSeconds": 0,
        "timedAnswered": 0,
        "timedPickup": 0,
        "averageTalkSeconds": 0,
        "medianTalkSeconds": 0,
        "p95TalkSeconds": 0,
        "averagePickupMs": 0,
        "p95PickupMs": 0,
        "shortAnswered": 0,
        "video": 0,
        "directions": {
          "inbound": {
            "total": 0,
            "answered": 0,
            "missed": 0,
            "declined": 0,
            "failed": 0,
            "ringing": 0,
            "answerRate": 0,
            "talkSeconds": 0,
            "timedAnswered": 0,
            "timedPickup": 0,
            "averageTalkSeconds": 0,
            "medianTalkSeconds": 0,
            "p95TalkSeconds": 0,
            "averagePickupMs": 0,
            "p95PickupMs": 0,
            "shortAnswered": 0,
            "video": 0
          },
          "outbound": {
            "total": 0,
            "answered": 0,
            "missed": 0,
            "declined": 0,
            "failed": 0,
            "ringing": 0,
            "answerRate": 0,
            "talkSeconds": 0,
            "timedAnswered": 0,
            "timedPickup": 0,
            "averageTalkSeconds": 0,
            "medianTalkSeconds": 0,
            "p95TalkSeconds": 0,
            "averagePickupMs": 0,
            "p95PickupMs": 0,
            "shortAnswered": 0,
            "video": 0
          }
        },
        "mediaQuality": {
          "measuredCalls": 0,
          "averageJitterMs": 0,
          "averageRttMs": 0,
          "packetsLost": 0
        },
        "appQuality": {
          "measuredCalls": 0,
          "averageJitterMs": 0,
          "averageRttMs": 0,
          "packetLossRate": 0,
          "reconnects": 0
        },
        "endReasons": [
          {
            "code": "string",
            "count": 0
          }
        ],
        "appErrors": [
          {
            "code": "string",
            "count": 0
          }
        ],
        "transports": [
          {
            "code": "string",
            "count": 0
          }
        ],
        "multiParticipantCalls": 0,
        "followUp": {
          "eligibleMissed": 0,
          "returnedWithin24h": 0,
          "rate": 0,
          "averageDelayMs": 0,
          "pendingWindow": 0,
          "unknownContact": 0
        }
      },
      "deviceAnalytics": {
        "detector": "message_id_prefix/v1",
        "measured": true,
        "complete": true,
        "observedBuckets": 0,
        "customerMessages": 0,
        "accountMessages": 0,
        "customerPlatforms": [
          {
            "platform": "web",
            "messages": 0,
            "share": 0
          }
        ],
        "accountPlatforms": [
          {
            "platform": "web",
            "messages": 0,
            "share": 0
          }
        ],
        "inventory": {
          "listObserved": true,
          "listCurrent": true,
          "observedAt": 0,
          "deviceCount": 0,
          "truncated": true,
          "devices": [
            {
              "deviceIndex": null,
              "estimatedPlatform": "web",
              "reportedClass": "phone",
              "lastActiveAt": null,
              "listed": null
            }
          ]
        }
      },
      "conversationBreakdown": {
        "measured": true,
        "complete": true,
        "observedBuckets": 0,
        "droppedConversations": 0,
        "truncated": true,
        "buckets": [
          {
            "ts": 0,
            "complete": true
          }
        ],
        "rows": [
          {
            "ts": 0,
            "messageType": "text",
            "textBand": "none",
            "origin": "api",
            "recipientCountry": "string",
            "recipientDeviceCount": "primary_only",
            "callingCode": "string",
            "customerDevices": "single",
            "completedConversations": 0,
            "deliveredConversations": 0,
            "readConversations": 0,
            "repliedConversations": 0,
            "replyLatencySumMs": 0,
            "readRate": 0,
            "replyRate": 0,
            "averageCustomerReplyMs": 0
          }
        ]
      },
      "recipientActivity": {
        "measured": true,
        "complete": true,
        "observedBuckets": 0,
        "droppedSignals": 0,
        "truncated": true,
        "rows": [
          {
            "ts": 0,
            "recipientCountry": "string",
            "recipientDeviceCount": "primary_only",
            "deviceSource": "primary",
            "incomingMessages": 0,
            "deliveryReceipts": 0,
            "readReceipts": 0,
            "onlineSignals": 0,
            "offlineSignals": 0,
            "typingSignals": 0,
            "lastSignalAt": 0,
            "quietGaps": 0,
            "quietGapMs": 0,
            "averageQuietGapMs": 0
          }
        ]
      }
    }
  ],
  "series": [
    {
      "ts": 0,
      "outgoingMessages": 0,
      "incomingMessages": 0,
      "sendFailures": 0,
      "businessReplies": 0,
      "averageBusinessResponseMs": 0,
      "onlineMs": 0,
      "disconnects": 0,
      "sessionId": "00000000-0000-4000-8000-000000000000",
      "customerOnlineSignals": 0,
      "customerTypingSignals": 0,
      "primaryPhoneMessages": 0,
      "otherDeviceMessages": 0,
      "primaryPhoneReplies": 0,
      "phoneActivePeriods": 0,
      "completedPhoneActivityPeriods": 0,
      "phoneActivityMs": 0,
      "phoneQuietGaps": 0,
      "phoneQuietMs": 0
    }
  ],
  "callSeries": [
    {
      "total": 0,
      "answered": 0,
      "missed": 0,
      "declined": 0,
      "failed": 0,
      "ringing": 0,
      "answerRate": 0,
      "talkSeconds": 0,
      "timedAnswered": 0,
      "timedPickup": 0,
      "averageTalkSeconds": 0,
      "medianTalkSeconds": 0,
      "p95TalkSeconds": 0,
      "averagePickupMs": 0,
      "p95PickupMs": 0,
      "shortAnswered": 0,
      "video": 0,
      "sessionId": "00000000-0000-4000-8000-000000000000",
      "ts": 0
    }
  ]
}
```

## Export team analytics metrics

`GET https://api.polymorfa.com/platform/analytics/metrics` (Platform API)

Required permission: `sessions:read`

**Required scope:** `sessions:read`

Authenticated metrics for a customer's Prometheus or OpenTelemetry Collector. Requires live Analytics enablement. Disabled Analytics returns only enablement and export-window metrics, with no business measurements. All samples are gauges: counts describe an overlapping window, not monotonic counters. Do not use rate() or increase() on them. Labels contain number/project record IDs and bounded categories, never contact identities or message content. Null or unmeasured values are omitted; coverage and observation timestamps are included. API request vitals retain project/team scope even when filtering a number.

### Query parameters

- `projectId` (string (uuid), format uuid). Identifier of the Polymorfa project that owns this resource.
- `sessionId` (string (uuid), format uuid). One number record UUID, within the authorized project or team.
- `windowHours` (integer, range 1–168). Number of completed UTC hours in the window, ending at the most recent hour boundary. Default 24; maximum 168. Default: `24`.
- `segments` (string). Include message type, text length, origin, calling-code and device-count breakdowns. Adds metric series. Values: `true`, `false`. Default: `"false"`.
- `format` (string). Prometheus text 0.0.4 or OpenMetrics text 1.0. The format parameter selects the representation. Values: `prometheus`, `openmetrics`. Default: `"prometheus"`.

### Request

```bash
curl "https://api.polymorfa.com/platform/analytics/metrics" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Windowed analytics gauges. OpenMetrics ends with # EOF. No JSON envelope.

Content type: `text/plain`, `application/openmetrics-text`

Headers:

- `X-RateLimit-Limit` (integer, min 1). Team request quota per rolling minute, when the per-team request limiter applies.
- `X-RateLimit-Remaining` (integer, min 0). Requests left in the per-team quota; zero when this limiter rejects the request.
- `X-RateLimit-Reset` (integer, min 0). Unix timestamp in seconds when the oldest counted request leaves the rolling window, when the per-team request limiter applies. Follow Retry-After on a rejected request.

#### 400

Bad request — request body or params failed validation
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable machine-readable code for this result. Values: `zero_knowledge_session`, `invalid_parameter`, `invalid_credential`, `entitlement_required`, `gate_limit_reached`, `billing_credit_required`, `addon_required`, `safe_mode_not_entitled`, `warmup_plan_not_entitled`, `method_not_allowed`, `permission_denied`, `missing_scope`, `resource_not_found`, `hms_not_enabled`, `media_fetch_failed`, `resource_gone`, `feature_unavailable`, `stream_cursor_invalid`, `stream_cursor_expired`, `stream_connection_limit_reached`, `state_conflict`, `team_deletion_scheduled`, `hybrid_choice_required`, `hybrid_group_linked_devices_unavailable`, `terms_acceptance_required`, `terms_activation_blocked`, `idempotency_conflict`, `idempotency_in_progress`, `idempotency_outcome_unknown`, `idempotency_replay_unavailable`, `call_claimed`, `call_not_ringing`, `connection_limit`, `unsupported_for_connection`, `call_permission_required`, `invalid_sip_trunk`, `calls_disabled`, `call_recipient_opted_out`, `call_destination_blocked`, `call_permission_request_limited`, `call_permission_granted`, `call_opt_out_limit`, `number_restricted`, `sip_trunk_in_use`, `sip_trunk_revision_conflict`, `sip_trunk_limit`, `sip_unavailable`, `voice_not_enabled`, `provider_credential_invalid`, `provider_unavailable`, `asset_not_ready`, `voice_asset_in_use`, `voice_asset_revision_conflict`, `voice_unavailable`, `rate_limit_exceeded`, `internal_error`, `operation_not_supported`, `upstream_failure`, `service_unavailable`, `credential_verification_unavailable`, `session_not_ready`, `command_dispatch_failed`, `result_unknown`, `parent_bsuid_not_supported`, `recipient_not_on_whatsapp`, `conversation_window_closed`, `template_not_approved`, `media_too_large`, `whatsapp_rate_limited`, `new_chat_limit_reached`, `marketing_disabled_on_cloud_api`, `whatsapp_account_restricted`, `whatsapp_authorization_required`, `whatsapp_payment_method_required`, `whatsapp_number_not_registered`, `bansafe_suspended`, `bansafe_team_suspended`, `bansafe_cold_blocked`, `bansafe_cold_held`, `bansafe_throttled`, `bansafe_daily_allowance_reached`, `bansafe_accounting_unavailable`, `bansafe_send_outcome_unknown`, `campaigns_not_entitled`, `campaign_throughput_capped`, `campaign_approval_required`, `campaign_approval_stale`, `campaign_variables_missing`.
  - `message` (string, required). Human-readable message associated with this result.
  - `param` (string, required, nullable). Specifies param for this error.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Specifies docs for this management platform access public error.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing or invalid authentication token
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but not permitted (missing scope or rule violation)
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

Resource not found
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

#### 500

Internal server error
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "An unexpected service failure occurred. Keep the request ID for support.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#internal-error"
}
```

#### 503

Analytics query deadline exceeded. Retry later or use a shorter window.
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "api_error",
    "code": "service_unavailable",
    "message": "A required service is unavailable. Check completion before repeating a write.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#service-unavailable"
}
```

## Export project analytics metrics

`GET https://api.polymorfa.com/platform/projects/{projectId}/analytics/metrics` (Platform API)

Required permission: `sessions:read`

**Required scope:** `sessions:read`

Authenticated metrics for a customer's Prometheus or OpenTelemetry Collector. Requires live Analytics enablement. Disabled Analytics returns only enablement and export-window metrics, with no business measurements. All samples are gauges: counts describe an overlapping window, not monotonic counters. Do not use rate() or increase() on them. Labels contain number/project record IDs and bounded categories, never contact identities or message content. Null or unmeasured values are omitted; coverage and observation timestamps are included. API request vitals retain project/team scope even when filtering a number.

### Path parameters

- `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.

### Query parameters

- `sessionId` (string (uuid), format uuid). One number record UUID, within the authorized project or team.
- `windowHours` (integer, range 1–168). Number of completed UTC hours in the window, ending at the most recent hour boundary. Default 24; maximum 168. Default: `24`.
- `segments` (string). Include message type, text length, origin, calling-code and device-count breakdowns. Adds metric series. Values: `true`, `false`. Default: `"false"`.
- `format` (string). Prometheus text 0.0.4 or OpenMetrics text 1.0. The format parameter selects the representation. Values: `prometheus`, `openmetrics`. Default: `"prometheus"`.

### Request

```bash
curl "https://api.polymorfa.com/platform/projects/<projectId>/analytics/metrics" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Windowed analytics gauges. OpenMetrics ends with # EOF. No JSON envelope.

Content type: `text/plain`, `application/openmetrics-text`

Headers:

- `X-RateLimit-Limit` (integer, min 1). Team request quota per rolling minute, when the per-team request limiter applies.
- `X-RateLimit-Remaining` (integer, min 0). Requests left in the per-team quota; zero when this limiter rejects the request.
- `X-RateLimit-Reset` (integer, min 0). Unix timestamp in seconds when the oldest counted request leaves the rolling window, when the per-team request limiter applies. Follow Retry-After on a rejected request.

#### 400

Bad request — request body or params failed validation
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable machine-readable code for this result. Values: `zero_knowledge_session`, `invalid_parameter`, `invalid_credential`, `entitlement_required`, `gate_limit_reached`, `billing_credit_required`, `addon_required`, `safe_mode_not_entitled`, `warmup_plan_not_entitled`, `method_not_allowed`, `permission_denied`, `missing_scope`, `resource_not_found`, `hms_not_enabled`, `media_fetch_failed`, `resource_gone`, `feature_unavailable`, `stream_cursor_invalid`, `stream_cursor_expired`, `stream_connection_limit_reached`, `state_conflict`, `team_deletion_scheduled`, `hybrid_choice_required`, `hybrid_group_linked_devices_unavailable`, `terms_acceptance_required`, `terms_activation_blocked`, `idempotency_conflict`, `idempotency_in_progress`, `idempotency_outcome_unknown`, `idempotency_replay_unavailable`, `call_claimed`, `call_not_ringing`, `connection_limit`, `unsupported_for_connection`, `call_permission_required`, `invalid_sip_trunk`, `calls_disabled`, `call_recipient_opted_out`, `call_destination_blocked`, `call_permission_request_limited`, `call_permission_granted`, `call_opt_out_limit`, `number_restricted`, `sip_trunk_in_use`, `sip_trunk_revision_conflict`, `sip_trunk_limit`, `sip_unavailable`, `voice_not_enabled`, `provider_credential_invalid`, `provider_unavailable`, `asset_not_ready`, `voice_asset_in_use`, `voice_asset_revision_conflict`, `voice_unavailable`, `rate_limit_exceeded`, `internal_error`, `operation_not_supported`, `upstream_failure`, `service_unavailable`, `credential_verification_unavailable`, `session_not_ready`, `command_dispatch_failed`, `result_unknown`, `parent_bsuid_not_supported`, `recipient_not_on_whatsapp`, `conversation_window_closed`, `template_not_approved`, `media_too_large`, `whatsapp_rate_limited`, `new_chat_limit_reached`, `marketing_disabled_on_cloud_api`, `whatsapp_account_restricted`, `whatsapp_authorization_required`, `whatsapp_payment_method_required`, `whatsapp_number_not_registered`, `bansafe_suspended`, `bansafe_team_suspended`, `bansafe_cold_blocked`, `bansafe_cold_held`, `bansafe_throttled`, `bansafe_daily_allowance_reached`, `bansafe_accounting_unavailable`, `bansafe_send_outcome_unknown`, `campaigns_not_entitled`, `campaign_throughput_capped`, `campaign_approval_required`, `campaign_approval_stale`, `campaign_variables_missing`.
  - `message` (string, required). Human-readable message associated with this result.
  - `param` (string, required, nullable). Specifies param for this error.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Specifies docs for this management platform access public error.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing or invalid authentication token
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but not permitted (missing scope or rule violation)
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

Resource not found
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

#### 500

Internal server error
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "An unexpected service failure occurred. Keep the request ID for support.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#internal-error"
}
```

#### 503

Analytics query deadline exceeded. Retry later or use a shorter window.
Same fields as 400.

Headers:

- `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`: described under 200.

```json
{
  "error": {
    "type": "api_error",
    "code": "service_unavailable",
    "message": "A required service is unavailable. Check completion before repeating a write.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#service-unavailable"
}
```

## Read team analytics

`GET https://api.polymorfa.com/platform/analytics` (Platform API)

Required permission: `sessions:read`

Aggregated number activity and operational vitals. Returns disabled with null summary and empty data until a team owner or admin enables Analytics. Conversation rates use completed 24-hour direct-chat cohorts, booked in the period when they mature; missing or dropped cohort coverage returns null rates. Read means an observed read receipt, not a verified app open. No contact identifiers or message content. Linked Devices telemetry only; unsupported or unobserved numbers carry measured=false. Bucket timestamps use UTC. Activity series use hourly buckets for ranges up to 48 hours and daily buckets for longer ranges. Call series use daily buckets. Message metadata compares direct sends and completed conversations by type, coarse text/caption length, source, calling code and observed device count. Device observations are bounded samples. Calling-code shares describe conversations, not distinct people or location. Presence signals require existing subscriptions. Primary phone activity spans end at their last observed signal and close after 15 minutes without evidence. Quiet gaps end at the next observed signal. Duration sums and averages count completed intervals and exclude open or restart-censored intervals; they do not measure phone online/offline or power state. Metadata collection uses the current team opt-in; disable erases these aggregates and stale queued metadata is rejected. Calls aggregate retained records by their immutable original number/project ownership, including supported Official API calls; message measured/coverage fields do not apply to calls. Call series groups starts by UTC day. Answer rate excludes still-ringing calls; timing fields have explicit observation counts. Missed-call follow-up observes an answered outgoing call to the same pseudonymous contact within 24h, including after the requested end; only completed windows with a known contact form the denominator. It does not prove callback intent. Quality uses reported measurements, latest cumulative app reports per connection and per-call averages. Breakdown counts can overlap. Disabling hides this call view without deleting operational call history. Device analytics estimates sending client families from message ID prefixes, not verified hardware. Customer/account distributions count observed live direct messages, not unique people or installed devices; unknown is included. Older retained buckets lack device coverage and return null shares. Each number exposes at most 25 of its own device indexes, coarse reported class and last observed sending activity. A list change makes inventory membership/count unknown until another full list. Inventory is null in the combined summary. No recipient device identity or raw message ID is retained by this analytics block. Joint conversation breakdown rows retain first outgoing message type, length band, send source, inferred calling code and observed customer device-count class together with UTC completion bucket. Combine rows matching all selected categories to drill into countries and message attributes without inferring intersections from independent marginal totals. Calling codes do not establish current location and shared codes do not identify a unique country. Counts describe completed 24-hour conversation cohorts, not distinct customers. Rates and averages are null when coverage is missing, dropped or truncated. At most 4096 number/time/category groups are returned in one scope, prioritizing largest groups and marking truncation; raw reply latency sums support weighted aggregation. Connection/call vitals and live message platform distributions are separate measurements, not recipient-country filtered cohorts. Recipient country and recipient linked-device-count fields refine joint conversation metadata. Recipient activity remains hourly even for long date ranges, supporting incoming-message timing in an explicit time zone. Delivery signals do not prove reading; read signals are distinct. Presence subscriptions are best-effort around permitted direct sends, reuse a live bounded local lease, preserve observation-off policies and never poll every contact. Missing presence is Unknown, not offline.

Requires `sessions:read`. Project tokens only access resources in their own project.

### Query parameters

- `projectId` (string). Project to read. Omit to total every project in the team.
- `sessionId` (string (uuid), format uuid). Identifier of the connected Polymorfa session.
- `start` (integer, min 0). Specifies start for this query parameter.
- `end` (integer, min 0). Specifies end for this query parameter.

### Request

```bash
curl "https://api.polymorfa.com/platform/analytics" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `enabled` (boolean, required). Whether this feature is enabled.
  - `period` (object, required). Structured period values for this management whats app analytic.
    - `start` (integer, required). Unix milliseconds.
    - `end` (integer, required). Unix milliseconds.
  - `requestVitals` (object, required). Structured request vitals values for this management whats app analytic.
    - `requests` (integer, required, min 0). Specifies requests for this request vital.
    - `failures` (integer, required, min 0). Specifies failures for this request vital.
    - `errorRate` (number, required, nullable, range 0–1). Specifies error rate for this request vital.
  - `summary` (object, required, nullable). Structured summary values for this management whats app analytic.
    - `measured` (boolean, required). Whether measured.
    - `observedHours` (integer, required, min 0). Specifies observed hours for this all of.
    - `lastObservedAt` (integer, required, nullable). Unix milliseconds.
    - `outgoingMessages` (integer, required, min 0). Specifies outgoing messages for this all of.
    - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this all of.
    - `sendAttempts` (integer, required, min 0). Specifies send attempts for this all of.
    - `sendFailures` (integer, required, min 0). Specifies send failures for this all of.
    - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this all of.
    - `businessReplies` (integer, required, min 0). Specifies business replies for this all of.
    - `averageBusinessResponseMs` (number, required, nullable, min 0). Specifies average business response ms for this all of.
    - `onlineMs` (integer, required, min 0). Specifies online ms for this all of.
    - `disconnects` (integer, required, min 0). Specifies disconnects for this all of.
    - `connectFailures` (integer, required, min 0). Specifies connect failures for this all of.
    - `streamErrors` (integer, required, min 0). Specifies stream errors for this all of.
    - `keepaliveTimeouts` (integer, required, min 0). Specifies keepalive timeouts for this all of.
    - `engagement` (object, required). Structured engagement values for this all of.
      - `windowHours` (integer, required). Specifies window hours for this engagement. Values: `24`.
      - `completedConversations` (integer, required, min 0). Specifies completed conversations for this engagement.
      - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this engagement.
      - `readConversations` (integer, required, min 0). Specifies read conversations for this engagement.
      - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this engagement.
      - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this engagement.
      - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this engagement.
      - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this engagement.
      - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this engagement.
      - `complete` (boolean, required). Whether complete.
      - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this engagement.
      - `droppedRecords` (integer, required, min 0). Specifies dropped records for this engagement.
      - `droppedReceiptJoins` (integer, required, min 0). Specifies dropped receipt joins for this engagement.
    - `totalNumbers` (integer, required, min 0). Specifies total numbers for this all of.
    - `measuredNumbers` (integer, required, min 0). Specifies measured numbers for this all of.
    - `connectedNumbers` (integer, required, min 0). Specifies connected numbers for this all of.
    - `messageAnalysis` (object, required). Structured message analysis values for this all of.
      - `complete` (boolean, required). Whether complete.
      - `segments` (array of object, required). Segments associated with this message analysi.
        - `dimension` (string, required). Specifies dimension for this segment. Values: `message_type`, `text_band`, `origin`, `calling_code`, `customer_devices`.
        - `key` (string, required). Specifies key for this segment.
        - `sendAttempts` (integer, required, min 0). Specifies send attempts for this segment.
        - `sent` (integer, required, min 0). Specifies sent for this segment.
        - `sendFailures` (integer, required, min 0). Specifies send failures for this segment.
        - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this segment.
        - `completedConversations` (integer, required, min 0). Specifies completed conversations for this segment.
        - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this segment.
        - `readConversations` (integer, required, min 0). Specifies read conversations for this segment.
        - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this segment.
        - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this segment.
        - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this segment.
        - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this segment.
        - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this segment.
        - `shareOfConversations` (number, required, nullable, range 0–1). Specifies share of conversations for this segment.
        - `shareOfSends` (number, required, nullable, range 0–1). Specifies share of sends for this segment.
        - `readRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
        - `replyRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
        - `readRateDifference` (number, required, nullable, range -1–1). Specifies read rate difference for this segment.
        - `replyRateDifference` (number, required, nullable, range -1–1). Specifies reply rate difference for this segment.
    - `customerActivity` (object, required). Structured customer activity values for this all of.
      - `observed` (boolean, required). Whether observed.
      - `onlineSignals` (integer, required, min 0). Specifies online signals for this customer activity.
      - `offlineSignals` (integer, required, min 0). Specifies offline signals for this customer activity.
      - `typingSignals` (integer, required, min 0). Specifies typing signals for this customer activity.
    - `accountActivity` (object, required). Structured account activity values for this all of.
      - `observed` (boolean, required). Whether observed.
      - `primaryPhoneActivitySignals` (integer, required, min 0). Specifies primary phone activity signals for this account activity.
      - `primaryPhoneActivePeriods` (integer, required, min 0). Specifies primary phone active periods for this account activity.
      - `completedPhoneActivityPeriods` (integer, required, min 0). Specifies completed phone activity periods for this account activity.
      - `phoneActivityMs` (integer, required, min 0). Specifies phone activity ms for this account activity.
      - `averagePhoneActivityMs` (number, required, nullable, min 0). Specifies average phone activity ms for this account activity.
      - `phoneQuietGaps` (integer, required, min 0). Specifies phone quiet gaps for this account activity.
      - `phoneQuietMs` (integer, required, min 0). Specifies phone quiet ms for this account activity.
      - `averagePhoneQuietMs` (number, required, nullable, min 0). Specifies average phone quiet ms for this account activity.
      - `primaryPhoneMessages` (integer, required, min 0). Specifies primary phone messages for this account activity.
      - `otherDeviceMessages` (integer, required, min 0). Specifies other device messages for this account activity.
      - `lastPrimaryPhoneAt` (integer, required, nullable). Unix milliseconds.
      - `primaryPhoneReplies` (integer, required, min 0). Specifies primary phone replies for this account activity.
      - `otherDeviceReplies` (integer, required, min 0). Specifies other device replies for this account activity.
      - `averagePrimaryPhoneResponseMs` (number, required, nullable, min 0). Specifies average primary phone response ms for this account activity.
      - `averageOtherDeviceResponseMs` (number, required, nullable, min 0). Specifies average other device response ms for this account activity.
    - `responseQueue` (object, required, nullable). Structured response queue values for this all of.
      - `awaitingReply` (integer, required, min 0). Specifies awaiting reply for this all of.
      - `oldestWaitingMs` (integer, required, min 0). Specifies oldest waiting ms for this all of.
      - `observedAt` (integer, required). Unix milliseconds.
      - `complete` (boolean, required). Whether complete.
    - `calls` (object, required). Structured calls values for this all of.
      - `total` (integer, required, min 0). Final total for this order or price summary.
      - `answered` (integer, required, min 0). Specifies answered for this call.
      - `missed` (integer, required, min 0). Specifies missed for this call.
      - `declined` (integer, required, min 0). Specifies declined for this call.
      - `failed` (integer, required, min 0). Specifies failed for this call.
      - `ringing` (integer, required, min 0). Specifies ringing for this call.
      - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this call.
      - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this call.
      - `timedAnswered` (integer, required, min 0). Specifies timed answered for this call.
      - `timedPickup` (integer, required, min 0). Specifies timed pickup for this call.
      - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this call.
      - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this call.
      - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this call.
      - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this call.
      - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this call.
      - `shortAnswered` (integer, required, min 0). Specifies short answered for this call.
      - `video` (integer, required, min 0). Specifies video for this call.
      - `directions` (object, required). Structured directions values for this call.
        - `inbound` (object, required). Structured inbound values for this direction.
          - `total` (integer, required, min 0). Final total for this order or price summary.
          - `answered` (integer, required, min 0). Specifies answered for this inbound.
          - `missed` (integer, required, min 0). Specifies missed for this inbound.
          - `declined` (integer, required, min 0). Specifies declined for this inbound.
          - `failed` (integer, required, min 0). Specifies failed for this inbound.
          - `ringing` (integer, required, min 0). Specifies ringing for this inbound.
          - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this inbound.
          - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this inbound.
          - `timedAnswered` (integer, required, min 0). Specifies timed answered for this inbound.
          - `timedPickup` (integer, required, min 0). Specifies timed pickup for this inbound.
          - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this inbound.
          - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this inbound.
          - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this inbound.
          - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this inbound.
          - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this inbound.
          - `shortAnswered` (integer, required, min 0). Specifies short answered for this inbound.
          - `video` (integer, required, min 0). Specifies video for this inbound.
        - `outbound` (object, required). Structured outbound values for this direction.
          - `total` (integer, required, min 0). Final total for this order or price summary.
          - `answered` (integer, required, min 0). Specifies answered for this outbound.
          - `missed` (integer, required, min 0). Specifies missed for this outbound.
          - `declined` (integer, required, min 0). Specifies declined for this outbound.
          - `failed` (integer, required, min 0). Specifies failed for this outbound.
          - `ringing` (integer, required, min 0). Specifies ringing for this outbound.
          - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this outbound.
          - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this outbound.
          - `timedAnswered` (integer, required, min 0). Specifies timed answered for this outbound.
          - `timedPickup` (integer, required, min 0). Specifies timed pickup for this outbound.
          - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this outbound.
          - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this outbound.
          - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this outbound.
          - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this outbound.
          - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this outbound.
          - `shortAnswered` (integer, required, min 0). Specifies short answered for this outbound.
          - `video` (integer, required, min 0). Specifies video for this outbound.
      - `mediaQuality` (object, required). Structured media quality values for this call.
        - `measuredCalls` (integer, required, min 0). Specifies measured calls for this media quality.
        - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this media quality.
        - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this media quality.
        - `packetsLost` (integer, required, nullable, min 0). Specifies packets lost for this media quality.
      - `appQuality` (object, required). Structured app quality values for this call.
        - `measuredCalls` (integer, required, min 0). Specifies measured calls for this app quality.
        - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this app quality.
        - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this app quality.
        - `packetLossRate` (number, required, nullable, range 0–1). Specifies packet loss rate for this app quality.
        - `reconnects` (integer, required, nullable, min 0). Specifies reconnects for this app quality.
      - `endReasons` (array of object, required). End reasons associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `appErrors` (array of object, required). App errors associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `transports` (array of object, required). Transports associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `multiParticipantCalls` (integer, required, min 0). Specifies multi participant calls for this call.
      - `followUp` (object, required). Structured follow up values for this call.
        - `eligibleMissed` (integer, required, min 0). Specifies eligible missed for this follow up.
        - `returnedWithin24h` (integer, required, min 0). Specifies returned within24h for this follow up.
        - `rate` (number, required, nullable, range 0–1). Specifies rate for this follow up.
        - `averageDelayMs` (number, required, nullable, min 0). Specifies average delay ms for this follow up.
        - `pendingWindow` (integer, required, min 0). Specifies pending window for this follow up.
        - `unknownContact` (integer, required, min 0). Specifies unknown contact for this follow up.
    - `deviceAnalytics` (object, required). Observed message client-family distributions and a bounded inventory of this number's own devices. The combined summary has null inventory.
      - `detector` (string, required). Specifies detector for this device analytic. Values: `message_id_prefix/v1`.
      - `measured` (boolean, required). True when at least one retained bucket has client-family measurement coverage, including buckets with zero messages.
      - `complete` (boolean, required). True when measured is true, every retained bucket has device-family coverage and conversation receipt coverage is complete. False when coverage is missing or records, conversations or receipt joins were dropped. Inventory truncation is reported separately.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this device analytic.
      - `customerMessages` (integer, required, nullable, min 0). Specifies customer messages for this device analytic.
      - `accountMessages` (integer, required, nullable, min 0). Specifies account messages for this device analytic.
      - `customerPlatforms` (array of object, required). Customer platforms associated with this device analytic.
        - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `messages` (integer, required, min 0). Specifies messages for this customer platform.
        - `share` (number, required, nullable, range 0–1). Specifies share for this customer platform.
      - `accountPlatforms` (array of object, required). Account platforms associated with this device analytic.
        - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `messages` (integer, required, min 0). Specifies messages for this account platform.
        - `share` (number, required, nullable, range 0–1). Specifies share for this account platform.
      - `inventory` (object, required, nullable). Structured inventory values for this device analytic.
        - `listObserved` (boolean, required). True after a full device list for this number was observed.
        - `listCurrent` (boolean, required). True when a full list was observed and no later list-change signal invalidated it. Membership and device count are unknown until another full list after a change.
        - `observedAt` (integer, required, nullable). Unix milliseconds.
        - `deviceCount` (integer, required, nullable, min 0). Number of devices.
        - `truncated` (boolean, required). True when the bounded inventory omitted devices. At most 25 device rows are returned; a current full-list device count can be larger.
        - `devices` (array of object, required, max items 25). Devices associated with this inventory.
          - `deviceIndex` (integer, required, range 0–999). Specifies device index for this device.
          - `estimatedPlatform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
          - `reportedClass` (string, required). Specifies reported class for this device. Values: `phone`, `desktop_app`, `browser`, `business_api`, `unknown` (No recognized reported device class.).
          - `lastActiveAt` (integer, required, nullable). Unix milliseconds.
          - `listed` (boolean, required, nullable). Whether this device index belongs to the latest observed full list. Null when that list is no longer current.
    - `conversationBreakdown` (object, required). Completed 24-hour conversation cohorts grouped jointly by completion bucket, first outgoing message metadata, calling code and observed device-count class.
      - `measured` (boolean, required). True when at least one retained bucket includes joint conversation categories.
      - `complete` (boolean, required). True when measured is true, every retained bucket has joint conversation coverage, no conversation, record or receipt-join coverage was lost and the returned groups are not truncated. Rates and averages are null when false.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this conversation breakdown.
      - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this conversation breakdown.
      - `truncated` (boolean, required). True when the requested scope exceeded 4096 number/time/category groups. The largest groups are retained; rates and averages are null.
      - `buckets` (array of object, required). Buckets associated with this conversation breakdown.
        - `ts` (integer, required). Unix milliseconds.
        - `complete` (boolean, required). True when this UTC time bucket has joint category coverage and no conversations or records were dropped. A summary bucket also requires every scoped number to have a bucket.
      - `rows` (array of object, required, max items 4096). Rows associated with this conversation breakdown.
        - `ts` (integer, required). Unix milliseconds.
        - `messageType` (string, required). Category assigned to message. Values: `text`, `image`, `video`, `audio`, `document`, `sticker`, `interactive`, `template`, `other`.
        - `textBand` (string, required). Specifies text band for this row. Values: `none`, `short`, `medium`, `long`, `very_long`, `unknown`.
        - `origin` (string, required). Specifies origin for this row. Values: `api` (API send.), `campaign` (Campaign send.), `other` (Other or unclassified send source.).
        - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Numbering country inferred from a full phone number or valid BSUID prefix; Unknown for missing historical metadata. Not current location.
        - `recipientDeviceCount` (string, required). Observed linked-device range; device zero is the primary and is excluded from linked counts. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
        - `callingCode` (string, required, pattern ^(unknown|[1-9][0-9]{0,2})$). Machine-readable calling code for this row.
        - `customerDevices` (string, required). Specifies customer devices for this row. Values: `single`, `multiple`, `unknown`.
        - `completedConversations` (integer, required, min 0). Specifies completed conversations for this row.
        - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this row.
        - `readConversations` (integer, required, min 0). Specifies read conversations for this row.
        - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this row.
        - `replyLatencySumMs` (integer, required, min 0). Specifies reply latency sum ms for this row.
        - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this row.
        - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this row.
        - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this row.
    - `recipientActivity` (object). Hourly aggregate recipient observations, grouped jointly by numbering country, observed linked-device count and sender-device class. Incoming messages and matched delivery/read receipts are deduplicated by native message and device in bounded memory. Presence is user-level and uses Unknown device source. Quiet gaps of at least 15 minutes are completed gaps between observed signals on the same device, never verified offline periods. No recipient identity, native message ID or recipient device index is retained. Coverage is explicit; older retained buckets are unmeasured. Message telemetry remains Linked Devices only; Official API message activity is not measured.
      - `measured` (boolean, required). Whether measured.
      - `complete` (boolean, required). Whether complete.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this recipient activity.
      - `droppedSignals` (integer, required, min 0). Specifies dropped signals for this recipient activity.
      - `truncated` (boolean, required). Whether truncated.
      - `rows` (array of object, required, max items 4096). Rows associated with this recipient activity.
        - `ts` (integer, required). Unix milliseconds.
        - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Specifies recipient country for this row.
        - `recipientDeviceCount` (string, required). Number of recipient devices. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
        - `deviceSource` (string, required). Specifies device source for this row. Values: `primary`, `linked`, `unknown`.
        - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this row.
        - `deliveryReceipts` (integer, required, min 0). Specifies delivery receipts for this row.
        - `readReceipts` (integer, required, min 0). Specifies read receipts for this row.
        - `onlineSignals` (integer, required, min 0). Specifies online signals for this row.
        - `offlineSignals` (integer, required, min 0). Specifies offline signals for this row.
        - `typingSignals` (integer, required, min 0). Specifies typing signals for this row.
        - `lastSignalAt` (integer, required). Unix milliseconds.
        - `quietGaps` (integer, required, min 0). Specifies quiet gaps for this row.
        - `quietGapMs` (integer, required, min 0). Specifies quiet gap ms for this row.
        - `averageQuietGapMs` (number, required, nullable, min 0). Specifies average quiet gap ms for this row.
  - `numbers` (array of object, required). Numbers associated with this management whats app analytic.
    - `sessionId` (string (uuid), required, format uuid). Identifier of the connected Polymorfa session.
    - `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
    - `name` (string, required). Human-readable name for this resource.
    - `backend` (string, required). Specifies backend for this number.
    - `status` (string, required). Current status of this resource or operation.
    - `measured` (boolean, required). Whether measured.
    - `observedHours` (integer, required, min 0). Specifies observed hours for this number.
    - `lastObservedAt` (integer, required, nullable). Unix milliseconds.
    - `outgoingMessages` (integer, required, min 0). Specifies outgoing messages for this number.
    - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this number.
    - `sendAttempts` (integer, required, min 0). Specifies send attempts for this number.
    - `sendFailures` (integer, required, min 0). Specifies send failures for this number.
    - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this number.
    - `businessReplies` (integer, required, min 0). Specifies business replies for this number.
    - `averageBusinessResponseMs` (number, required, nullable, min 0). Specifies average business response ms for this number.
    - `onlineMs` (integer, required, min 0). Specifies online ms for this number.
    - `disconnects` (integer, required, min 0). Specifies disconnects for this number.
    - `connectFailures` (integer, required, min 0). Specifies connect failures for this number.
    - `streamErrors` (integer, required, min 0). Specifies stream errors for this number.
    - `keepaliveTimeouts` (integer, required, min 0). Specifies keepalive timeouts for this number.
    - `engagement` (object, required). Structured engagement values for this number.
      - `windowHours` (integer, required). Specifies window hours for this engagement. Values: `24`.
      - `completedConversations` (integer, required, min 0). Specifies completed conversations for this engagement.
      - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this engagement.
      - `readConversations` (integer, required, min 0). Specifies read conversations for this engagement.
      - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this engagement.
      - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this engagement.
      - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this engagement.
      - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this engagement.
      - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this engagement.
      - `complete` (boolean, required). Whether complete.
      - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this engagement.
      - `droppedRecords` (integer, required, min 0). Specifies dropped records for this engagement.
      - `droppedReceiptJoins` (integer, required, min 0). Specifies dropped receipt joins for this engagement.
    - `messageAnalysis` (object, required). Structured message analysis values for this number.
      - `complete` (boolean, required). Whether complete.
      - `segments` (array of object, required). Segments associated with this message analysi.
        - `dimension` (string, required). Specifies dimension for this segment. Values: `message_type`, `text_band`, `origin`, `calling_code`, `customer_devices`.
        - `key` (string, required). Specifies key for this segment.
        - `sendAttempts` (integer, required, min 0). Specifies send attempts for this segment.
        - `sent` (integer, required, min 0). Specifies sent for this segment.
        - `sendFailures` (integer, required, min 0). Specifies send failures for this segment.
        - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this segment.
        - `completedConversations` (integer, required, min 0). Specifies completed conversations for this segment.
        - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this segment.
        - `readConversations` (integer, required, min 0). Specifies read conversations for this segment.
        - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this segment.
        - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this segment.
        - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this segment.
        - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this segment.
        - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this segment.
        - `shareOfConversations` (number, required, nullable, range 0–1). Specifies share of conversations for this segment.
        - `shareOfSends` (number, required, nullable, range 0–1). Specifies share of sends for this segment.
        - `readRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
        - `replyRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
        - `readRateDifference` (number, required, nullable, range -1–1). Specifies read rate difference for this segment.
        - `replyRateDifference` (number, required, nullable, range -1–1). Specifies reply rate difference for this segment.
    - `customerActivity` (object, required). Structured customer activity values for this number.
      - `observed` (boolean, required). Whether observed.
      - `onlineSignals` (integer, required, min 0). Specifies online signals for this customer activity.
      - `offlineSignals` (integer, required, min 0). Specifies offline signals for this customer activity.
      - `typingSignals` (integer, required, min 0). Specifies typing signals for this customer activity.
    - `accountActivity` (object, required). Structured account activity values for this number.
      - `observed` (boolean, required). Whether observed.
      - `primaryPhoneActivitySignals` (integer, required, min 0). Specifies primary phone activity signals for this account activity.
      - `primaryPhoneActivePeriods` (integer, required, min 0). Specifies primary phone active periods for this account activity.
      - `completedPhoneActivityPeriods` (integer, required, min 0). Specifies completed phone activity periods for this account activity.
      - `phoneActivityMs` (integer, required, min 0). Specifies phone activity ms for this account activity.
      - `averagePhoneActivityMs` (number, required, nullable, min 0). Specifies average phone activity ms for this account activity.
      - `phoneQuietGaps` (integer, required, min 0). Specifies phone quiet gaps for this account activity.
      - `phoneQuietMs` (integer, required, min 0). Specifies phone quiet ms for this account activity.
      - `averagePhoneQuietMs` (number, required, nullable, min 0). Specifies average phone quiet ms for this account activity.
      - `primaryPhoneMessages` (integer, required, min 0). Specifies primary phone messages for this account activity.
      - `otherDeviceMessages` (integer, required, min 0). Specifies other device messages for this account activity.
      - `lastPrimaryPhoneAt` (integer, required, nullable). Unix milliseconds.
      - `primaryPhoneReplies` (integer, required, min 0). Specifies primary phone replies for this account activity.
      - `otherDeviceReplies` (integer, required, min 0). Specifies other device replies for this account activity.
      - `averagePrimaryPhoneResponseMs` (number, required, nullable, min 0). Specifies average primary phone response ms for this account activity.
      - `averageOtherDeviceResponseMs` (number, required, nullable, min 0). Specifies average other device response ms for this account activity.
    - `responseQueue` (object, required, nullable). Structured response queue values for this number.
      - `awaitingReply` (integer, required, min 0). Specifies awaiting reply for this all of.
      - `oldestWaitingMs` (integer, required, min 0). Specifies oldest waiting ms for this all of.
      - `observedAt` (integer, required). Unix milliseconds.
      - `complete` (boolean, required). Whether complete.
    - `projectName` (string, required). Human-readable project name for this number.
    - `calls` (object, required). Structured calls values for this number.
      - `total` (integer, required, min 0). Final total for this order or price summary.
      - `answered` (integer, required, min 0). Specifies answered for this call.
      - `missed` (integer, required, min 0). Specifies missed for this call.
      - `declined` (integer, required, min 0). Specifies declined for this call.
      - `failed` (integer, required, min 0). Specifies failed for this call.
      - `ringing` (integer, required, min 0). Specifies ringing for this call.
      - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this call.
      - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this call.
      - `timedAnswered` (integer, required, min 0). Specifies timed answered for this call.
      - `timedPickup` (integer, required, min 0). Specifies timed pickup for this call.
      - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this call.
      - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this call.
      - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this call.
      - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this call.
      - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this call.
      - `shortAnswered` (integer, required, min 0). Specifies short answered for this call.
      - `video` (integer, required, min 0). Specifies video for this call.
      - `directions` (object, required). Structured directions values for this call.
        - `inbound` (object, required). Structured inbound values for this direction.
          - `total` (integer, required, min 0). Final total for this order or price summary.
          - `answered` (integer, required, min 0). Specifies answered for this inbound.
          - `missed` (integer, required, min 0). Specifies missed for this inbound.
          - `declined` (integer, required, min 0). Specifies declined for this inbound.
          - `failed` (integer, required, min 0). Specifies failed for this inbound.
          - `ringing` (integer, required, min 0). Specifies ringing for this inbound.
          - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this inbound.
          - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this inbound.
          - `timedAnswered` (integer, required, min 0). Specifies timed answered for this inbound.
          - `timedPickup` (integer, required, min 0). Specifies timed pickup for this inbound.
          - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this inbound.
          - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this inbound.
          - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this inbound.
          - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this inbound.
          - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this inbound.
          - `shortAnswered` (integer, required, min 0). Specifies short answered for this inbound.
          - `video` (integer, required, min 0). Specifies video for this inbound.
        - `outbound` (object, required). Structured outbound values for this direction.
          - `total` (integer, required, min 0). Final total for this order or price summary.
          - `answered` (integer, required, min 0). Specifies answered for this outbound.
          - `missed` (integer, required, min 0). Specifies missed for this outbound.
          - `declined` (integer, required, min 0). Specifies declined for this outbound.
          - `failed` (integer, required, min 0). Specifies failed for this outbound.
          - `ringing` (integer, required, min 0). Specifies ringing for this outbound.
          - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this outbound.
          - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this outbound.
          - `timedAnswered` (integer, required, min 0). Specifies timed answered for this outbound.
          - `timedPickup` (integer, required, min 0). Specifies timed pickup for this outbound.
          - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this outbound.
          - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this outbound.
          - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this outbound.
          - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this outbound.
          - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this outbound.
          - `shortAnswered` (integer, required, min 0). Specifies short answered for this outbound.
          - `video` (integer, required, min 0). Specifies video for this outbound.
      - `mediaQuality` (object, required). Structured media quality values for this call.
        - `measuredCalls` (integer, required, min 0). Specifies measured calls for this media quality.
        - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this media quality.
        - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this media quality.
        - `packetsLost` (integer, required, nullable, min 0). Specifies packets lost for this media quality.
      - `appQuality` (object, required). Structured app quality values for this call.
        - `measuredCalls` (integer, required, min 0). Specifies measured calls for this app quality.
        - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this app quality.
        - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this app quality.
        - `packetLossRate` (number, required, nullable, range 0–1). Specifies packet loss rate for this app quality.
        - `reconnects` (integer, required, nullable, min 0). Specifies reconnects for this app quality.
      - `endReasons` (array of object, required). End reasons associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `appErrors` (array of object, required). App errors associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `transports` (array of object, required). Transports associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `multiParticipantCalls` (integer, required, min 0). Specifies multi participant calls for this call.
      - `followUp` (object, required). Structured follow up values for this call.
        - `eligibleMissed` (integer, required, min 0). Specifies eligible missed for this follow up.
        - `returnedWithin24h` (integer, required, min 0). Specifies returned within24h for this follow up.
        - `rate` (number, required, nullable, range 0–1). Specifies rate for this follow up.
        - `averageDelayMs` (number, required, nullable, min 0). Specifies average delay ms for this follow up.
        - `pendingWindow` (integer, required, min 0). Specifies pending window for this follow up.
        - `unknownContact` (integer, required, min 0). Specifies unknown contact for this follow up.
    - `deviceAnalytics` (object, required). Observed message client-family distributions and a bounded inventory of this number's own devices. The combined summary has null inventory.
      - `detector` (string, required). Specifies detector for this device analytic. Values: `message_id_prefix/v1`.
      - `measured` (boolean, required). True when at least one retained bucket has client-family measurement coverage, including buckets with zero messages.
      - `complete` (boolean, required). True when measured is true, every retained bucket has device-family coverage and conversation receipt coverage is complete. False when coverage is missing or records, conversations or receipt joins were dropped. Inventory truncation is reported separately.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this device analytic.
      - `customerMessages` (integer, required, nullable, min 0). Specifies customer messages for this device analytic.
      - `accountMessages` (integer, required, nullable, min 0). Specifies account messages for this device analytic.
      - `customerPlatforms` (array of object, required). Customer platforms associated with this device analytic.
        - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `messages` (integer, required, min 0). Specifies messages for this customer platform.
        - `share` (number, required, nullable, range 0–1). Specifies share for this customer platform.
      - `accountPlatforms` (array of object, required). Account platforms associated with this device analytic.
        - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `messages` (integer, required, min 0). Specifies messages for this account platform.
        - `share` (number, required, nullable, range 0–1). Specifies share for this account platform.
      - `inventory` (object, required, nullable). Structured inventory values for this device analytic.
        - `listObserved` (boolean, required). True after a full device list for this number was observed.
        - `listCurrent` (boolean, required). True when a full list was observed and no later list-change signal invalidated it. Membership and device count are unknown until another full list after a change.
        - `observedAt` (integer, required, nullable). Unix milliseconds.
        - `deviceCount` (integer, required, nullable, min 0). Number of devices.
        - `truncated` (boolean, required). True when the bounded inventory omitted devices. At most 25 device rows are returned; a current full-list device count can be larger.
        - `devices` (array of object, required, max items 25). Devices associated with this inventory.
    - `conversationBreakdown` (object, required). Completed 24-hour conversation cohorts grouped jointly by completion bucket, first outgoing message metadata, calling code and observed device-count class.
      - `measured` (boolean, required). True when at least one retained bucket includes joint conversation categories.
      - `complete` (boolean, required). True when measured is true, every retained bucket has joint conversation coverage, no conversation, record or receipt-join coverage was lost and the returned groups are not truncated. Rates and averages are null when false.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this conversation breakdown.
      - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this conversation breakdown.
      - `truncated` (boolean, required). True when the requested scope exceeded 4096 number/time/category groups. The largest groups are retained; rates and averages are null.
      - `buckets` (array of object, required). Buckets associated with this conversation breakdown.
        - `ts` (integer, required). Unix milliseconds.
        - `complete` (boolean, required). True when this UTC time bucket has joint category coverage and no conversations or records were dropped. A summary bucket also requires every scoped number to have a bucket.
      - `rows` (array of object, required, max items 4096). Rows associated with this conversation breakdown.
        - `ts` (integer, required). Unix milliseconds.
        - `messageType` (string, required). Category assigned to message. Values: `text`, `image`, `video`, `audio`, `document`, `sticker`, `interactive`, `template`, `other`.
        - `textBand` (string, required). Specifies text band for this row. Values: `none`, `short`, `medium`, `long`, `very_long`, `unknown`.
        - `origin` (string, required). Specifies origin for this row. Values: `api` (API send.), `campaign` (Campaign send.), `other` (Other or unclassified send source.).
        - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Numbering country inferred from a full phone number or valid BSUID prefix; Unknown for missing historical metadata. Not current location.
        - `recipientDeviceCount` (string, required). Observed linked-device range; device zero is the primary and is excluded from linked counts. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
        - `callingCode` (string, required, pattern ^(unknown|[1-9][0-9]{0,2})$). Machine-readable calling code for this row.
        - `customerDevices` (string, required). Specifies customer devices for this row. Values: `single`, `multiple`, `unknown`.
        - `completedConversations` (integer, required, min 0). Specifies completed conversations for this row.
        - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this row.
        - `readConversations` (integer, required, min 0). Specifies read conversations for this row.
        - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this row.
        - `replyLatencySumMs` (integer, required, min 0). Specifies reply latency sum ms for this row.
        - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this row.
        - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this row.
        - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this row.
    - `recipientActivity` (object). Hourly aggregate recipient observations, grouped jointly by numbering country, observed linked-device count and sender-device class. Incoming messages and matched delivery/read receipts are deduplicated by native message and device in bounded memory. Presence is user-level and uses Unknown device source. Quiet gaps of at least 15 minutes are completed gaps between observed signals on the same device, never verified offline periods. No recipient identity, native message ID or recipient device index is retained. Coverage is explicit; older retained buckets are unmeasured. Message telemetry remains Linked Devices only; Official API message activity is not measured.
      - `measured` (boolean, required). Whether measured.
      - `complete` (boolean, required). Whether complete.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this recipient activity.
      - `droppedSignals` (integer, required, min 0). Specifies dropped signals for this recipient activity.
      - `truncated` (boolean, required). Whether truncated.
      - `rows` (array of object, required, max items 4096). Rows associated with this recipient activity.
        - `ts` (integer, required). Unix milliseconds.
        - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Specifies recipient country for this row.
        - `recipientDeviceCount` (string, required). Number of recipient devices. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
        - `deviceSource` (string, required). Specifies device source for this row. Values: `primary`, `linked`, `unknown`.
        - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this row.
        - `deliveryReceipts` (integer, required, min 0). Specifies delivery receipts for this row.
        - `readReceipts` (integer, required, min 0). Specifies read receipts for this row.
        - `onlineSignals` (integer, required, min 0). Specifies online signals for this row.
        - `offlineSignals` (integer, required, min 0). Specifies offline signals for this row.
        - `typingSignals` (integer, required, min 0). Specifies typing signals for this row.
        - `lastSignalAt` (integer, required). Unix milliseconds.
        - `quietGaps` (integer, required, min 0). Specifies quiet gaps for this row.
        - `quietGapMs` (integer, required, min 0). Specifies quiet gap ms for this row.
        - `averageQuietGapMs` (number, required, nullable, min 0). Specifies average quiet gap ms for this row.
  - `series` (array of object, required). Series associated with this management whats app analytic.
    - `ts` (integer, required). Unix milliseconds.
    - `outgoingMessages` (integer, required, min 0). Specifies outgoing messages for this sery.
    - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this sery.
    - `sendFailures` (integer, required, min 0). Specifies send failures for this sery.
    - `businessReplies` (integer, required, min 0). Specifies business replies for this sery.
    - `averageBusinessResponseMs` (number, required, nullable, min 0). Specifies average business response ms for this sery.
    - `onlineMs` (integer, required, min 0). Specifies online ms for this sery.
    - `disconnects` (integer, required, min 0). Specifies disconnects for this sery.
    - `sessionId` (string (uuid), required, format uuid). Identifier of the connected Polymorfa session.
    - `customerOnlineSignals` (integer, required, min 0). Specifies customer online signals for this sery.
    - `customerTypingSignals` (integer, required, min 0). Specifies customer typing signals for this sery.
    - `primaryPhoneMessages` (integer, required, min 0). Specifies primary phone messages for this sery.
    - `otherDeviceMessages` (integer, required, min 0). Specifies other device messages for this sery.
    - `primaryPhoneReplies` (integer, required, min 0). Specifies primary phone replies for this sery.
    - `phoneActivePeriods` (integer, required, min 0). Specifies phone active periods for this sery.
    - `completedPhoneActivityPeriods` (integer, required, min 0). Specifies completed phone activity periods for this sery.
    - `phoneActivityMs` (integer, required, min 0). Specifies phone activity ms for this sery.
    - `phoneQuietGaps` (integer, required, min 0). Specifies phone quiet gaps for this sery.
    - `phoneQuietMs` (integer, required, min 0). Specifies phone quiet ms for this sery.
  - `callSeries` (array of object, required). Call series associated with this management whats app analytic.
    - `total` (integer, required, min 0). Final total for this order or price summary.
    - `answered` (integer, required, min 0). Specifies answered for this call sery.
    - `missed` (integer, required, min 0). Specifies missed for this call sery.
    - `declined` (integer, required, min 0). Specifies declined for this call sery.
    - `failed` (integer, required, min 0). Specifies failed for this call sery.
    - `ringing` (integer, required, min 0). Specifies ringing for this call sery.
    - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this call sery.
    - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this call sery.
    - `timedAnswered` (integer, required, min 0). Specifies timed answered for this call sery.
    - `timedPickup` (integer, required, min 0). Specifies timed pickup for this call sery.
    - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this call sery.
    - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this call sery.
    - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this call sery.
    - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this call sery.
    - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this call sery.
    - `shortAnswered` (integer, required, min 0). Specifies short answered for this call sery.
    - `video` (integer, required, min 0). Specifies video for this call sery.
    - `sessionId` (string (uuid), required, format uuid). Identifier of the connected Polymorfa session.
    - `ts` (integer, required). Unix milliseconds.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "enabled": true,
    "period": {
      "start": 0,
      "end": 0
    },
    "requestVitals": {
      "requests": 0,
      "failures": 0,
      "errorRate": 0
    },
    "summary": {
      "measured": true,
      "observedHours": 0,
      "lastObservedAt": 0,
      "outgoingMessages": 0,
      "incomingMessages": 0,
      "sendAttempts": 0,
      "sendFailures": 0,
      "sendFailureRate": 0,
      "businessReplies": 0,
      "averageBusinessResponseMs": 0,
      "onlineMs": 0,
      "disconnects": 0,
      "connectFailures": 0,
      "streamErrors": 0,
      "keepaliveTimeouts": 0,
      "engagement": {
        "windowHours": 24,
        "completedConversations": 0,
        "deliveredConversations": 0,
        "readConversations": 0,
        "repliedConversations": 0,
        "deliveryRate": 0,
        "readRate": 0,
        "replyRate": 0,
        "averageCustomerReplyMs": 0,
        "complete": true,
        "droppedConversations": 0,
        "droppedRecords": 0,
        "droppedReceiptJoins": 0
      },
      "totalNumbers": 0,
      "measuredNumbers": 0,
      "connectedNumbers": 0,
      "messageAnalysis": {
        "complete": true,
        "segments": [
          {
            "dimension": "message_type",
            "key": "string",
            "sendAttempts": 0,
            "sent": 0,
            "sendFailures": 0,
            "sendFailureRate": 0,
            "completedConversations": 0,
            "deliveredConversations": 0,
            "readConversations": 0,
            "repliedConversations": 0,
            "deliveryRate": 0,
            "readRate": 0,
            "replyRate": 0,
            "averageCustomerReplyMs": 0,
            "shareOfConversations": 0,
            "shareOfSends": 0,
            "readRateInterval95": [
              null
            ],
            "replyRateInterval95": [
              null
            ],
            "readRateDifference": -1,
            "replyRateDifference": -1
          }
        ]
      },
      "customerActivity": {
        "observed": true,
        "onlineSignals": 0,
        "offlineSignals": 0,
        "typingSignals": 0
      },
      "accountActivity": {
        "observed": true,
        "primaryPhoneActivitySignals": 0,
        "primaryPhoneActivePeriods": 0,
        "completedPhoneActivityPeriods": 0,
        "phoneActivityMs": 0,
        "averagePhoneActivityMs": 0,
        "phoneQuietGaps": 0,
        "phoneQuietMs": 0,
        "averagePhoneQuietMs": 0,
        "primaryPhoneMessages": 0,
        "otherDeviceMessages": 0,
        "lastPrimaryPhoneAt": 0,
        "primaryPhoneReplies": 0,
        "otherDeviceReplies": 0,
        "averagePrimaryPhoneResponseMs": 0,
        "averageOtherDeviceResponseMs": 0
      },
      "responseQueue": {
        "awaitingReply": 0,
        "oldestWaitingMs": 0,
        "observedAt": 0,
        "complete": true
      },
      "calls": {
        "total": 0,
        "answered": 0,
        "missed": 0,
        "declined": 0,
        "failed": 0,
        "ringing": 0,
        "answerRate": 0,
        "talkSeconds": 0,
        "timedAnswered": 0,
        "timedPickup": 0,
        "averageTalkSeconds": 0,
        "medianTalkSeconds": 0,
        "p95TalkSeconds": 0,
        "averagePickupMs": 0,
        "p95PickupMs": 0,
        "shortAnswered": 0,
        "video": 0,
        "directions": {
          "inbound": {
            "total": 0,
            "answered": 0,
            "missed": 0,
            "declined": 0,
            "failed": 0,
            "ringing": 0,
            "answerRate": 0,
            "talkSeconds": 0,
            "timedAnswered": 0,
            "timedPickup": 0,
            "averageTalkSeconds": 0,
            "medianTalkSeconds": 0,
            "p95TalkSeconds": 0,
            "averagePickupMs": 0,
            "p95PickupMs": 0,
            "shortAnswered": 0,
            "video": 0
          },
          "outbound": {
            "total": 0,
            "answered": 0,
            "missed": 0,
            "declined": 0,
            "failed": 0,
            "ringing": 0,
            "answerRate": 0,
            "talkSeconds": 0,
            "timedAnswered": 0,
            "timedPickup": 0,
            "averageTalkSeconds": 0,
            "medianTalkSeconds": 0,
            "p95TalkSeconds": 0,
            "averagePickupMs": 0,
            "p95PickupMs": 0,
            "shortAnswered": 0,
            "video": 0
          }
        },
        "mediaQuality": {
          "measuredCalls": 0,
          "averageJitterMs": 0,
          "averageRttMs": 0,
          "packetsLost": 0
        },
        "appQuality": {
          "measuredCalls": 0,
          "averageJitterMs": 0,
          "averageRttMs": 0,
          "packetLossRate": 0,
          "reconnects": 0
        },
        "endReasons": [
          {
            "code": "string",
            "count": 0
          }
        ],
        "appErrors": [
          {
            "code": "string",
            "count": 0
          }
        ],
        "transports": [
          {
            "code": "string",
            "count": 0
          }
        ],
        "multiParticipantCalls": 0,
        "followUp": {
          "eligibleMissed": 0,
          "returnedWithin24h": 0,
          "rate": 0,
          "averageDelayMs": 0,
          "pendingWindow": 0,
          "unknownContact": 0
        }
      },
      "deviceAnalytics": {
        "detector": "message_id_prefix/v1",
        "measured": true,
        "complete": true,
        "observedBuckets": 0,
        "customerMessages": 0,
        "accountMessages": 0,
        "customerPlatforms": [
          {
            "platform": "web",
            "messages": 0,
            "share": 0
          }
        ],
        "accountPlatforms": [
          {
            "platform": "web",
            "messages": 0,
            "share": 0
          }
        ],
        "inventory": {
          "listObserved": true,
          "listCurrent": true,
          "observedAt": 0,
          "deviceCount": 0,
          "truncated": true,
          "devices": [
            {
              "deviceIndex": null,
              "estimatedPlatform": "web",
              "reportedClass": "phone",
              "lastActiveAt": null,
              "listed": null
            }
          ]
        }
      },
      "conversationBreakdown": {
        "measured": true,
        "complete": true,
        "observedBuckets": 0,
        "droppedConversations": 0,
        "truncated": true,
        "buckets": [
          {
            "ts": 0,
            "complete": true
          }
        ],
        "rows": [
          {
            "ts": 0,
            "messageType": "text",
            "textBand": "none",
            "origin": "api",
            "recipientCountry": "string",
            "recipientDeviceCount": "primary_only",
            "callingCode": "string",
            "customerDevices": "single",
            "completedConversations": 0,
            "deliveredConversations": 0,
            "readConversations": 0,
            "repliedConversations": 0,
            "replyLatencySumMs": 0,
            "readRate": 0,
            "replyRate": 0,
            "averageCustomerReplyMs": 0
          }
        ]
      }
    },
    "numbers": [
      {
        "sessionId": "00000000-0000-4000-8000-000000000000",
        "projectId": "00000000-0000-4000-8000-000000000000",
        "name": "string",
        "backend": "string",
        "status": "string",
        "measured": true,
        "observedHours": 0,
        "lastObservedAt": 0,
        "outgoingMessages": 0,
        "incomingMessages": 0,
        "sendAttempts": 0,
        "sendFailures": 0,
        "sendFailureRate": 0,
        "businessReplies": 0,
        "averageBusinessResponseMs": 0,
        "onlineMs": 0,
        "disconnects": 0,
        "connectFailures": 0,
        "streamErrors": 0,
        "keepaliveTimeouts": 0,
        "engagement": {
          "windowHours": 24,
          "completedConversations": 0,
          "deliveredConversations": 0,
          "readConversations": 0,
          "repliedConversations": 0,
          "deliveryRate": 0,
          "readRate": 0,
          "replyRate": 0,
          "averageCustomerReplyMs": 0,
          "complete": true,
          "droppedConversations": 0,
          "droppedRecords": 0,
          "droppedReceiptJoins": 0
        },
        "messageAnalysis": {
          "complete": true,
          "segments": [
            {
              "dimension": "message_type",
              "key": null,
              "sendAttempts": null,
              "sent": null,
              "sendFailures": null,
              "sendFailureRate": null,
              "completedConversations": null,
              "deliveredConversations": null,
              "readConversations": null,
              "repliedConversations": null,
              "deliveryRate": null,
              "readRate": null,
              "replyRate": null,
              "averageCustomerReplyMs": null,
              "shareOfConversations": null,
              "shareOfSends": null,
              "readRateInterval95": null,
              "replyRateInterval95": null,
              "readRateDifference": null,
              "replyRateDifference": null
            }
          ]
        },
        "customerActivity": {
          "observed": true,
          "onlineSignals": 0,
          "offlineSignals": 0,
          "typingSignals": 0
        },
        "accountActivity": {
          "observed": true,
          "primaryPhoneActivitySignals": 0,
          "primaryPhoneActivePeriods": 0,
          "completedPhoneActivityPeriods": 0,
          "phoneActivityMs": 0,
          "averagePhoneActivityMs": 0,
          "phoneQuietGaps": 0,
          "phoneQuietMs": 0,
          "averagePhoneQuietMs": 0,
          "primaryPhoneMessages": 0,
          "otherDeviceMessages": 0,
          "lastPrimaryPhoneAt": 0,
          "primaryPhoneReplies": 0,
          "otherDeviceReplies": 0,
          "averagePrimaryPhoneResponseMs": 0,
          "averageOtherDeviceResponseMs": 0
        },
        "responseQueue": {
          "awaitingReply": 0,
          "oldestWaitingMs": 0,
          "observedAt": 0,
          "complete": true
        },
        "projectName": "string",
        "calls": {
          "total": 0,
          "answered": 0,
          "missed": 0,
          "declined": 0,
          "failed": 0,
          "ringing": 0,
          "answerRate": 0,
          "talkSeconds": 0,
          "timedAnswered": 0,
          "timedPickup": 0,
          "averageTalkSeconds": 0,
          "medianTalkSeconds": 0,
          "p95TalkSeconds": 0,
          "averagePickupMs": 0,
          "p95PickupMs": 0,
          "shortAnswered": 0,
          "video": 0,
          "directions": {
            "inbound": {
              "total": null,
              "answered": null,
              "missed": null,
              "declined": null,
              "failed": null,
              "ringing": null,
              "answerRate": null,
              "talkSeconds": null,
              "timedAnswered": null,
              "timedPickup": null,
              "averageTalkSeconds": null,
              "medianTalkSeconds": null,
              "p95TalkSeconds": null,
              "averagePickupMs": null,
              "p95PickupMs": null,
              "shortAnswered": null,
              "video": null
            },
            "outbound": {
              "total": null,
              "answered": null,
              "missed": null,
              "declined": null,
              "failed": null,
              "ringing": null,
              "answerRate": null,
              "talkSeconds": null,
              "timedAnswered": null,
              "timedPickup": null,
              "averageTalkSeconds": null,
              "medianTalkSeconds": null,
              "p95TalkSeconds": null,
              "averagePickupMs": null,
              "p95PickupMs": null,
              "shortAnswered": null,
              "video": null
            }
          },
          "mediaQuality": {
            "measuredCalls": 0,
            "averageJitterMs": 0,
            "averageRttMs": 0,
            "packetsLost": 0
          },
          "appQuality": {
            "measuredCalls": 0,
            "averageJitterMs": 0,
            "averageRttMs": 0,
            "packetLossRate": 0,
            "reconnects": 0
          },
          "endReasons": [
            {
              "code": null,
              "count": null
            }
          ],
          "appErrors": [
            {
              "code": null,
              "count": null
            }
          ],
          "transports": [
            {
              "code": null,
              "count": null
            }
          ],
          "multiParticipantCalls": 0,
          "followUp": {
            "eligibleMissed": 0,
            "returnedWithin24h": 0,
            "rate": 0,
            "averageDelayMs": 0,
            "pendingWindow": 0,
            "unknownContact": 0
          }
        },
        "deviceAnalytics": {
          "detector": "message_id_prefix/v1",
          "measured": true,
          "complete": true,
          "observedBuckets": 0,
          "customerMessages": 0,
          "accountMessages": 0,
          "customerPlatforms": [
            {
              "platform": "web",
              "messages": null,
              "share": null
            }
          ],
          "accountPlatforms": [
            {
              "platform": "web",
              "messages": null,
              "share": null
            }
          ],
          "inventory": {
            "listObserved": true,
            "listCurrent": true,
            "observedAt": 0,
            "deviceCount": 0,
            "truncated": true,
            "devices": [
              null
            ]
          }
        },
        "conversationBreakdown": {
          "measured": true,
          "complete": true,
          "observedBuckets": 0,
          "droppedConversations": 0,
          "truncated": true,
          "buckets": [
            {
              "ts": null,
              "complete": null
            }
          ],
          "rows": [
            {
              "ts": null,
              "messageType": "text",
              "textBand": "none",
              "origin": "api",
              "recipientCountry": null,
              "recipientDeviceCount": "primary_only",
              "callingCode": null,
              "customerDevices": "single",
              "completedConversations": null,
              "deliveredConversations": null,
              "readConversations": null,
              "repliedConversations": null,
              "replyLatencySumMs": null,
              "readRate": null,
              "replyRate": null,
              "averageCustomerReplyMs": null
            }
          ]
        }
      }
    ],
    "series": [
      {
        "ts": 0,
        "outgoingMessages": 0,
        "incomingMessages": 0,
        "sendFailures": 0,
        "businessReplies": 0,
        "averageBusinessResponseMs": 0,
        "onlineMs": 0,
        "disconnects": 0,
        "sessionId": "00000000-0000-4000-8000-000000000000",
        "customerOnlineSignals": 0,
        "customerTypingSignals": 0,
        "primaryPhoneMessages": 0,
        "otherDeviceMessages": 0,
        "primaryPhoneReplies": 0,
        "phoneActivePeriods": 0,
        "completedPhoneActivityPeriods": 0,
        "phoneActivityMs": 0,
        "phoneQuietGaps": 0,
        "phoneQuietMs": 0
      }
    ],
    "callSeries": [
      {
        "total": 0,
        "answered": 0,
        "missed": 0,
        "declined": 0,
        "failed": 0,
        "ringing": 0,
        "answerRate": 0,
        "talkSeconds": 0,
        "timedAnswered": 0,
        "timedPickup": 0,
        "averageTalkSeconds": 0,
        "medianTalkSeconds": 0,
        "p95TalkSeconds": 0,
        "averagePickupMs": 0,
        "p95PickupMs": 0,
        "shortAnswered": 0,
        "video": 0,
        "sessionId": "00000000-0000-4000-8000-000000000000",
        "ts": 0
      }
    ]
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

#### 503

The change was stored, but a connected number has not confirmed it. Retry the request; the stored setting is already correct and is retried automatically.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "api_error",
    "code": "service_unavailable",
    "message": "A required service is unavailable. Check completion before repeating a write.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#service-unavailable"
}
```

## Read project analytics

`GET https://api.polymorfa.com/platform/projects/{projectId}/analytics` (Platform API)

Required permission: `sessions:read`

Aggregated number activity and operational vitals. Returns disabled with null summary and empty data until a team owner or admin enables Analytics. Conversation rates use completed 24-hour direct-chat cohorts, booked in the period when they mature; missing or dropped cohort coverage returns null rates. Read means an observed read receipt, not a verified app open. No contact identifiers or message content. Linked Devices telemetry only; unsupported or unobserved numbers carry measured=false. Bucket timestamps use UTC. Activity series use hourly buckets for ranges up to 48 hours and daily buckets for longer ranges. Call series use daily buckets. Message metadata compares direct sends and completed conversations by type, coarse text/caption length, source, calling code and observed device count. Device observations are bounded samples. Calling-code shares describe conversations, not distinct people or location. Presence signals require existing subscriptions. Primary phone activity spans end at their last observed signal and close after 15 minutes without evidence. Quiet gaps end at the next observed signal. Duration sums and averages count completed intervals and exclude open or restart-censored intervals; they do not measure phone online/offline or power state. Metadata collection uses the current team opt-in; disable erases these aggregates and stale queued metadata is rejected. Calls aggregate retained records by their immutable original number/project ownership, including supported Official API calls; message measured/coverage fields do not apply to calls. Call series groups starts by UTC day. Answer rate excludes still-ringing calls; timing fields have explicit observation counts. Missed-call follow-up observes an answered outgoing call to the same pseudonymous contact within 24h, including after the requested end; only completed windows with a known contact form the denominator. It does not prove callback intent. Quality uses reported measurements, latest cumulative app reports per connection and per-call averages. Breakdown counts can overlap. Disabling hides this call view without deleting operational call history. Device analytics estimates sending client families from message ID prefixes, not verified hardware. Customer/account distributions count observed live direct messages, not unique people or installed devices; unknown is included. Older retained buckets lack device coverage and return null shares. Each number exposes at most 25 of its own device indexes, coarse reported class and last observed sending activity. A list change makes inventory membership/count unknown until another full list. Inventory is null in the combined summary. No recipient device identity or raw message ID is retained by this analytics block. Joint conversation breakdown rows retain first outgoing message type, length band, send source, inferred calling code and observed customer device-count class together with UTC completion bucket. Combine rows matching all selected categories to drill into countries and message attributes without inferring intersections from independent marginal totals. Calling codes do not establish current location and shared codes do not identify a unique country. Counts describe completed 24-hour conversation cohorts, not distinct customers. Rates and averages are null when coverage is missing, dropped or truncated. At most 4096 number/time/category groups are returned in one scope, prioritizing largest groups and marking truncation; raw reply latency sums support weighted aggregation. Connection/call vitals and live message platform distributions are separate measurements, not recipient-country filtered cohorts. Recipient country and recipient linked-device-count fields refine joint conversation metadata. Recipient activity remains hourly even for long date ranges, supporting incoming-message timing in an explicit time zone. Delivery signals do not prove reading; read signals are distinct. Presence subscriptions are best-effort around permitted direct sends, reuse a live bounded local lease, preserve observation-off policies and never poll every contact. Missing presence is Unknown, not offline.

Requires `sessions:read`. Project tokens only access resources in their own project.

### Path parameters

- `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.

### Query parameters

- `sessionId` (string (uuid), format uuid). Identifier of the connected Polymorfa session.
- `start` (integer, min 0). Specifies start for this query parameter.
- `end` (integer, min 0). Specifies end for this query parameter.

### Request

```bash
curl "https://api.polymorfa.com/platform/projects/<projectId>/analytics" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `enabled` (boolean, required). Whether this feature is enabled.
  - `period` (object, required). Structured period values for this management whats app analytic.
    - `start` (integer, required). Unix milliseconds.
    - `end` (integer, required). Unix milliseconds.
  - `requestVitals` (object, required). Structured request vitals values for this management whats app analytic.
    - `requests` (integer, required, min 0). Specifies requests for this request vital.
    - `failures` (integer, required, min 0). Specifies failures for this request vital.
    - `errorRate` (number, required, nullable, range 0–1). Specifies error rate for this request vital.
  - `summary` (object, required, nullable). Structured summary values for this management whats app analytic.
    - `measured` (boolean, required). Whether measured.
    - `observedHours` (integer, required, min 0). Specifies observed hours for this all of.
    - `lastObservedAt` (integer, required, nullable). Unix milliseconds.
    - `outgoingMessages` (integer, required, min 0). Specifies outgoing messages for this all of.
    - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this all of.
    - `sendAttempts` (integer, required, min 0). Specifies send attempts for this all of.
    - `sendFailures` (integer, required, min 0). Specifies send failures for this all of.
    - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this all of.
    - `businessReplies` (integer, required, min 0). Specifies business replies for this all of.
    - `averageBusinessResponseMs` (number, required, nullable, min 0). Specifies average business response ms for this all of.
    - `onlineMs` (integer, required, min 0). Specifies online ms for this all of.
    - `disconnects` (integer, required, min 0). Specifies disconnects for this all of.
    - `connectFailures` (integer, required, min 0). Specifies connect failures for this all of.
    - `streamErrors` (integer, required, min 0). Specifies stream errors for this all of.
    - `keepaliveTimeouts` (integer, required, min 0). Specifies keepalive timeouts for this all of.
    - `engagement` (object, required). Structured engagement values for this all of.
      - `windowHours` (integer, required). Specifies window hours for this engagement. Values: `24`.
      - `completedConversations` (integer, required, min 0). Specifies completed conversations for this engagement.
      - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this engagement.
      - `readConversations` (integer, required, min 0). Specifies read conversations for this engagement.
      - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this engagement.
      - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this engagement.
      - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this engagement.
      - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this engagement.
      - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this engagement.
      - `complete` (boolean, required). Whether complete.
      - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this engagement.
      - `droppedRecords` (integer, required, min 0). Specifies dropped records for this engagement.
      - `droppedReceiptJoins` (integer, required, min 0). Specifies dropped receipt joins for this engagement.
    - `totalNumbers` (integer, required, min 0). Specifies total numbers for this all of.
    - `measuredNumbers` (integer, required, min 0). Specifies measured numbers for this all of.
    - `connectedNumbers` (integer, required, min 0). Specifies connected numbers for this all of.
    - `messageAnalysis` (object, required). Structured message analysis values for this all of.
      - `complete` (boolean, required). Whether complete.
      - `segments` (array of object, required). Segments associated with this message analysi.
        - `dimension` (string, required). Specifies dimension for this segment. Values: `message_type`, `text_band`, `origin`, `calling_code`, `customer_devices`.
        - `key` (string, required). Specifies key for this segment.
        - `sendAttempts` (integer, required, min 0). Specifies send attempts for this segment.
        - `sent` (integer, required, min 0). Specifies sent for this segment.
        - `sendFailures` (integer, required, min 0). Specifies send failures for this segment.
        - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this segment.
        - `completedConversations` (integer, required, min 0). Specifies completed conversations for this segment.
        - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this segment.
        - `readConversations` (integer, required, min 0). Specifies read conversations for this segment.
        - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this segment.
        - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this segment.
        - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this segment.
        - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this segment.
        - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this segment.
        - `shareOfConversations` (number, required, nullable, range 0–1). Specifies share of conversations for this segment.
        - `shareOfSends` (number, required, nullable, range 0–1). Specifies share of sends for this segment.
        - `readRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
        - `replyRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
        - `readRateDifference` (number, required, nullable, range -1–1). Specifies read rate difference for this segment.
        - `replyRateDifference` (number, required, nullable, range -1–1). Specifies reply rate difference for this segment.
    - `customerActivity` (object, required). Structured customer activity values for this all of.
      - `observed` (boolean, required). Whether observed.
      - `onlineSignals` (integer, required, min 0). Specifies online signals for this customer activity.
      - `offlineSignals` (integer, required, min 0). Specifies offline signals for this customer activity.
      - `typingSignals` (integer, required, min 0). Specifies typing signals for this customer activity.
    - `accountActivity` (object, required). Structured account activity values for this all of.
      - `observed` (boolean, required). Whether observed.
      - `primaryPhoneActivitySignals` (integer, required, min 0). Specifies primary phone activity signals for this account activity.
      - `primaryPhoneActivePeriods` (integer, required, min 0). Specifies primary phone active periods for this account activity.
      - `completedPhoneActivityPeriods` (integer, required, min 0). Specifies completed phone activity periods for this account activity.
      - `phoneActivityMs` (integer, required, min 0). Specifies phone activity ms for this account activity.
      - `averagePhoneActivityMs` (number, required, nullable, min 0). Specifies average phone activity ms for this account activity.
      - `phoneQuietGaps` (integer, required, min 0). Specifies phone quiet gaps for this account activity.
      - `phoneQuietMs` (integer, required, min 0). Specifies phone quiet ms for this account activity.
      - `averagePhoneQuietMs` (number, required, nullable, min 0). Specifies average phone quiet ms for this account activity.
      - `primaryPhoneMessages` (integer, required, min 0). Specifies primary phone messages for this account activity.
      - `otherDeviceMessages` (integer, required, min 0). Specifies other device messages for this account activity.
      - `lastPrimaryPhoneAt` (integer, required, nullable). Unix milliseconds.
      - `primaryPhoneReplies` (integer, required, min 0). Specifies primary phone replies for this account activity.
      - `otherDeviceReplies` (integer, required, min 0). Specifies other device replies for this account activity.
      - `averagePrimaryPhoneResponseMs` (number, required, nullable, min 0). Specifies average primary phone response ms for this account activity.
      - `averageOtherDeviceResponseMs` (number, required, nullable, min 0). Specifies average other device response ms for this account activity.
    - `responseQueue` (object, required, nullable). Structured response queue values for this all of.
      - `awaitingReply` (integer, required, min 0). Specifies awaiting reply for this all of.
      - `oldestWaitingMs` (integer, required, min 0). Specifies oldest waiting ms for this all of.
      - `observedAt` (integer, required). Unix milliseconds.
      - `complete` (boolean, required). Whether complete.
    - `calls` (object, required). Structured calls values for this all of.
      - `total` (integer, required, min 0). Final total for this order or price summary.
      - `answered` (integer, required, min 0). Specifies answered for this call.
      - `missed` (integer, required, min 0). Specifies missed for this call.
      - `declined` (integer, required, min 0). Specifies declined for this call.
      - `failed` (integer, required, min 0). Specifies failed for this call.
      - `ringing` (integer, required, min 0). Specifies ringing for this call.
      - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this call.
      - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this call.
      - `timedAnswered` (integer, required, min 0). Specifies timed answered for this call.
      - `timedPickup` (integer, required, min 0). Specifies timed pickup for this call.
      - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this call.
      - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this call.
      - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this call.
      - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this call.
      - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this call.
      - `shortAnswered` (integer, required, min 0). Specifies short answered for this call.
      - `video` (integer, required, min 0). Specifies video for this call.
      - `directions` (object, required). Structured directions values for this call.
        - `inbound` (object, required). Structured inbound values for this direction.
          - `total` (integer, required, min 0). Final total for this order or price summary.
          - `answered` (integer, required, min 0). Specifies answered for this inbound.
          - `missed` (integer, required, min 0). Specifies missed for this inbound.
          - `declined` (integer, required, min 0). Specifies declined for this inbound.
          - `failed` (integer, required, min 0). Specifies failed for this inbound.
          - `ringing` (integer, required, min 0). Specifies ringing for this inbound.
          - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this inbound.
          - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this inbound.
          - `timedAnswered` (integer, required, min 0). Specifies timed answered for this inbound.
          - `timedPickup` (integer, required, min 0). Specifies timed pickup for this inbound.
          - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this inbound.
          - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this inbound.
          - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this inbound.
          - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this inbound.
          - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this inbound.
          - `shortAnswered` (integer, required, min 0). Specifies short answered for this inbound.
          - `video` (integer, required, min 0). Specifies video for this inbound.
        - `outbound` (object, required). Structured outbound values for this direction.
          - `total` (integer, required, min 0). Final total for this order or price summary.
          - `answered` (integer, required, min 0). Specifies answered for this outbound.
          - `missed` (integer, required, min 0). Specifies missed for this outbound.
          - `declined` (integer, required, min 0). Specifies declined for this outbound.
          - `failed` (integer, required, min 0). Specifies failed for this outbound.
          - `ringing` (integer, required, min 0). Specifies ringing for this outbound.
          - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this outbound.
          - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this outbound.
          - `timedAnswered` (integer, required, min 0). Specifies timed answered for this outbound.
          - `timedPickup` (integer, required, min 0). Specifies timed pickup for this outbound.
          - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this outbound.
          - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this outbound.
          - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this outbound.
          - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this outbound.
          - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this outbound.
          - `shortAnswered` (integer, required, min 0). Specifies short answered for this outbound.
          - `video` (integer, required, min 0). Specifies video for this outbound.
      - `mediaQuality` (object, required). Structured media quality values for this call.
        - `measuredCalls` (integer, required, min 0). Specifies measured calls for this media quality.
        - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this media quality.
        - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this media quality.
        - `packetsLost` (integer, required, nullable, min 0). Specifies packets lost for this media quality.
      - `appQuality` (object, required). Structured app quality values for this call.
        - `measuredCalls` (integer, required, min 0). Specifies measured calls for this app quality.
        - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this app quality.
        - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this app quality.
        - `packetLossRate` (number, required, nullable, range 0–1). Specifies packet loss rate for this app quality.
        - `reconnects` (integer, required, nullable, min 0). Specifies reconnects for this app quality.
      - `endReasons` (array of object, required). End reasons associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `appErrors` (array of object, required). App errors associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `transports` (array of object, required). Transports associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `multiParticipantCalls` (integer, required, min 0). Specifies multi participant calls for this call.
      - `followUp` (object, required). Structured follow up values for this call.
        - `eligibleMissed` (integer, required, min 0). Specifies eligible missed for this follow up.
        - `returnedWithin24h` (integer, required, min 0). Specifies returned within24h for this follow up.
        - `rate` (number, required, nullable, range 0–1). Specifies rate for this follow up.
        - `averageDelayMs` (number, required, nullable, min 0). Specifies average delay ms for this follow up.
        - `pendingWindow` (integer, required, min 0). Specifies pending window for this follow up.
        - `unknownContact` (integer, required, min 0). Specifies unknown contact for this follow up.
    - `deviceAnalytics` (object, required). Observed message client-family distributions and a bounded inventory of this number's own devices. The combined summary has null inventory.
      - `detector` (string, required). Specifies detector for this device analytic. Values: `message_id_prefix/v1`.
      - `measured` (boolean, required). True when at least one retained bucket has client-family measurement coverage, including buckets with zero messages.
      - `complete` (boolean, required). True when measured is true, every retained bucket has device-family coverage and conversation receipt coverage is complete. False when coverage is missing or records, conversations or receipt joins were dropped. Inventory truncation is reported separately.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this device analytic.
      - `customerMessages` (integer, required, nullable, min 0). Specifies customer messages for this device analytic.
      - `accountMessages` (integer, required, nullable, min 0). Specifies account messages for this device analytic.
      - `customerPlatforms` (array of object, required). Customer platforms associated with this device analytic.
        - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `messages` (integer, required, min 0). Specifies messages for this customer platform.
        - `share` (number, required, nullable, range 0–1). Specifies share for this customer platform.
      - `accountPlatforms` (array of object, required). Account platforms associated with this device analytic.
        - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `messages` (integer, required, min 0). Specifies messages for this account platform.
        - `share` (number, required, nullable, range 0–1). Specifies share for this account platform.
      - `inventory` (object, required, nullable). Structured inventory values for this device analytic.
        - `listObserved` (boolean, required). True after a full device list for this number was observed.
        - `listCurrent` (boolean, required). True when a full list was observed and no later list-change signal invalidated it. Membership and device count are unknown until another full list after a change.
        - `observedAt` (integer, required, nullable). Unix milliseconds.
        - `deviceCount` (integer, required, nullable, min 0). Number of devices.
        - `truncated` (boolean, required). True when the bounded inventory omitted devices. At most 25 device rows are returned; a current full-list device count can be larger.
        - `devices` (array of object, required, max items 25). Devices associated with this inventory.
          - `deviceIndex` (integer, required, range 0–999). Specifies device index for this device.
          - `estimatedPlatform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
          - `reportedClass` (string, required). Specifies reported class for this device. Values: `phone`, `desktop_app`, `browser`, `business_api`, `unknown` (No recognized reported device class.).
          - `lastActiveAt` (integer, required, nullable). Unix milliseconds.
          - `listed` (boolean, required, nullable). Whether this device index belongs to the latest observed full list. Null when that list is no longer current.
    - `conversationBreakdown` (object, required). Completed 24-hour conversation cohorts grouped jointly by completion bucket, first outgoing message metadata, calling code and observed device-count class.
      - `measured` (boolean, required). True when at least one retained bucket includes joint conversation categories.
      - `complete` (boolean, required). True when measured is true, every retained bucket has joint conversation coverage, no conversation, record or receipt-join coverage was lost and the returned groups are not truncated. Rates and averages are null when false.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this conversation breakdown.
      - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this conversation breakdown.
      - `truncated` (boolean, required). True when the requested scope exceeded 4096 number/time/category groups. The largest groups are retained; rates and averages are null.
      - `buckets` (array of object, required). Buckets associated with this conversation breakdown.
        - `ts` (integer, required). Unix milliseconds.
        - `complete` (boolean, required). True when this UTC time bucket has joint category coverage and no conversations or records were dropped. A summary bucket also requires every scoped number to have a bucket.
      - `rows` (array of object, required, max items 4096). Rows associated with this conversation breakdown.
        - `ts` (integer, required). Unix milliseconds.
        - `messageType` (string, required). Category assigned to message. Values: `text`, `image`, `video`, `audio`, `document`, `sticker`, `interactive`, `template`, `other`.
        - `textBand` (string, required). Specifies text band for this row. Values: `none`, `short`, `medium`, `long`, `very_long`, `unknown`.
        - `origin` (string, required). Specifies origin for this row. Values: `api` (API send.), `campaign` (Campaign send.), `other` (Other or unclassified send source.).
        - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Numbering country inferred from a full phone number or valid BSUID prefix; Unknown for missing historical metadata. Not current location.
        - `recipientDeviceCount` (string, required). Observed linked-device range; device zero is the primary and is excluded from linked counts. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
        - `callingCode` (string, required, pattern ^(unknown|[1-9][0-9]{0,2})$). Machine-readable calling code for this row.
        - `customerDevices` (string, required). Specifies customer devices for this row. Values: `single`, `multiple`, `unknown`.
        - `completedConversations` (integer, required, min 0). Specifies completed conversations for this row.
        - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this row.
        - `readConversations` (integer, required, min 0). Specifies read conversations for this row.
        - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this row.
        - `replyLatencySumMs` (integer, required, min 0). Specifies reply latency sum ms for this row.
        - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this row.
        - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this row.
        - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this row.
    - `recipientActivity` (object). Hourly aggregate recipient observations, grouped jointly by numbering country, observed linked-device count and sender-device class. Incoming messages and matched delivery/read receipts are deduplicated by native message and device in bounded memory. Presence is user-level and uses Unknown device source. Quiet gaps of at least 15 minutes are completed gaps between observed signals on the same device, never verified offline periods. No recipient identity, native message ID or recipient device index is retained. Coverage is explicit; older retained buckets are unmeasured. Message telemetry remains Linked Devices only; Official API message activity is not measured.
      - `measured` (boolean, required). Whether measured.
      - `complete` (boolean, required). Whether complete.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this recipient activity.
      - `droppedSignals` (integer, required, min 0). Specifies dropped signals for this recipient activity.
      - `truncated` (boolean, required). Whether truncated.
      - `rows` (array of object, required, max items 4096). Rows associated with this recipient activity.
        - `ts` (integer, required). Unix milliseconds.
        - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Specifies recipient country for this row.
        - `recipientDeviceCount` (string, required). Number of recipient devices. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
        - `deviceSource` (string, required). Specifies device source for this row. Values: `primary`, `linked`, `unknown`.
        - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this row.
        - `deliveryReceipts` (integer, required, min 0). Specifies delivery receipts for this row.
        - `readReceipts` (integer, required, min 0). Specifies read receipts for this row.
        - `onlineSignals` (integer, required, min 0). Specifies online signals for this row.
        - `offlineSignals` (integer, required, min 0). Specifies offline signals for this row.
        - `typingSignals` (integer, required, min 0). Specifies typing signals for this row.
        - `lastSignalAt` (integer, required). Unix milliseconds.
        - `quietGaps` (integer, required, min 0). Specifies quiet gaps for this row.
        - `quietGapMs` (integer, required, min 0). Specifies quiet gap ms for this row.
        - `averageQuietGapMs` (number, required, nullable, min 0). Specifies average quiet gap ms for this row.
  - `numbers` (array of object, required). Numbers associated with this management whats app analytic.
    - `sessionId` (string (uuid), required, format uuid). Identifier of the connected Polymorfa session.
    - `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
    - `name` (string, required). Human-readable name for this resource.
    - `backend` (string, required). Specifies backend for this number.
    - `status` (string, required). Current status of this resource or operation.
    - `measured` (boolean, required). Whether measured.
    - `observedHours` (integer, required, min 0). Specifies observed hours for this number.
    - `lastObservedAt` (integer, required, nullable). Unix milliseconds.
    - `outgoingMessages` (integer, required, min 0). Specifies outgoing messages for this number.
    - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this number.
    - `sendAttempts` (integer, required, min 0). Specifies send attempts for this number.
    - `sendFailures` (integer, required, min 0). Specifies send failures for this number.
    - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this number.
    - `businessReplies` (integer, required, min 0). Specifies business replies for this number.
    - `averageBusinessResponseMs` (number, required, nullable, min 0). Specifies average business response ms for this number.
    - `onlineMs` (integer, required, min 0). Specifies online ms for this number.
    - `disconnects` (integer, required, min 0). Specifies disconnects for this number.
    - `connectFailures` (integer, required, min 0). Specifies connect failures for this number.
    - `streamErrors` (integer, required, min 0). Specifies stream errors for this number.
    - `keepaliveTimeouts` (integer, required, min 0). Specifies keepalive timeouts for this number.
    - `engagement` (object, required). Structured engagement values for this number.
      - `windowHours` (integer, required). Specifies window hours for this engagement. Values: `24`.
      - `completedConversations` (integer, required, min 0). Specifies completed conversations for this engagement.
      - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this engagement.
      - `readConversations` (integer, required, min 0). Specifies read conversations for this engagement.
      - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this engagement.
      - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this engagement.
      - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this engagement.
      - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this engagement.
      - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this engagement.
      - `complete` (boolean, required). Whether complete.
      - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this engagement.
      - `droppedRecords` (integer, required, min 0). Specifies dropped records for this engagement.
      - `droppedReceiptJoins` (integer, required, min 0). Specifies dropped receipt joins for this engagement.
    - `messageAnalysis` (object, required). Structured message analysis values for this number.
      - `complete` (boolean, required). Whether complete.
      - `segments` (array of object, required). Segments associated with this message analysi.
        - `dimension` (string, required). Specifies dimension for this segment. Values: `message_type`, `text_band`, `origin`, `calling_code`, `customer_devices`.
        - `key` (string, required). Specifies key for this segment.
        - `sendAttempts` (integer, required, min 0). Specifies send attempts for this segment.
        - `sent` (integer, required, min 0). Specifies sent for this segment.
        - `sendFailures` (integer, required, min 0). Specifies send failures for this segment.
        - `sendFailureRate` (number, required, nullable, range 0–1). Specifies send failure rate for this segment.
        - `completedConversations` (integer, required, min 0). Specifies completed conversations for this segment.
        - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this segment.
        - `readConversations` (integer, required, min 0). Specifies read conversations for this segment.
        - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this segment.
        - `deliveryRate` (number, required, nullable, range 0–1). Specifies delivery rate for this segment.
        - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this segment.
        - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this segment.
        - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this segment.
        - `shareOfConversations` (number, required, nullable, range 0–1). Specifies share of conversations for this segment.
        - `shareOfSends` (number, required, nullable, range 0–1). Specifies share of sends for this segment.
        - `readRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
        - `replyRateInterval95` (array of number, required, nullable, items 2, item range 0–1). 95% Wilson interval for observed conversation receipts or replies; not a causal effect.
        - `readRateDifference` (number, required, nullable, range -1–1). Specifies read rate difference for this segment.
        - `replyRateDifference` (number, required, nullable, range -1–1). Specifies reply rate difference for this segment.
    - `customerActivity` (object, required). Structured customer activity values for this number.
      - `observed` (boolean, required). Whether observed.
      - `onlineSignals` (integer, required, min 0). Specifies online signals for this customer activity.
      - `offlineSignals` (integer, required, min 0). Specifies offline signals for this customer activity.
      - `typingSignals` (integer, required, min 0). Specifies typing signals for this customer activity.
    - `accountActivity` (object, required). Structured account activity values for this number.
      - `observed` (boolean, required). Whether observed.
      - `primaryPhoneActivitySignals` (integer, required, min 0). Specifies primary phone activity signals for this account activity.
      - `primaryPhoneActivePeriods` (integer, required, min 0). Specifies primary phone active periods for this account activity.
      - `completedPhoneActivityPeriods` (integer, required, min 0). Specifies completed phone activity periods for this account activity.
      - `phoneActivityMs` (integer, required, min 0). Specifies phone activity ms for this account activity.
      - `averagePhoneActivityMs` (number, required, nullable, min 0). Specifies average phone activity ms for this account activity.
      - `phoneQuietGaps` (integer, required, min 0). Specifies phone quiet gaps for this account activity.
      - `phoneQuietMs` (integer, required, min 0). Specifies phone quiet ms for this account activity.
      - `averagePhoneQuietMs` (number, required, nullable, min 0). Specifies average phone quiet ms for this account activity.
      - `primaryPhoneMessages` (integer, required, min 0). Specifies primary phone messages for this account activity.
      - `otherDeviceMessages` (integer, required, min 0). Specifies other device messages for this account activity.
      - `lastPrimaryPhoneAt` (integer, required, nullable). Unix milliseconds.
      - `primaryPhoneReplies` (integer, required, min 0). Specifies primary phone replies for this account activity.
      - `otherDeviceReplies` (integer, required, min 0). Specifies other device replies for this account activity.
      - `averagePrimaryPhoneResponseMs` (number, required, nullable, min 0). Specifies average primary phone response ms for this account activity.
      - `averageOtherDeviceResponseMs` (number, required, nullable, min 0). Specifies average other device response ms for this account activity.
    - `responseQueue` (object, required, nullable). Structured response queue values for this number.
      - `awaitingReply` (integer, required, min 0). Specifies awaiting reply for this all of.
      - `oldestWaitingMs` (integer, required, min 0). Specifies oldest waiting ms for this all of.
      - `observedAt` (integer, required). Unix milliseconds.
      - `complete` (boolean, required). Whether complete.
    - `projectName` (string, required). Human-readable project name for this number.
    - `calls` (object, required). Structured calls values for this number.
      - `total` (integer, required, min 0). Final total for this order or price summary.
      - `answered` (integer, required, min 0). Specifies answered for this call.
      - `missed` (integer, required, min 0). Specifies missed for this call.
      - `declined` (integer, required, min 0). Specifies declined for this call.
      - `failed` (integer, required, min 0). Specifies failed for this call.
      - `ringing` (integer, required, min 0). Specifies ringing for this call.
      - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this call.
      - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this call.
      - `timedAnswered` (integer, required, min 0). Specifies timed answered for this call.
      - `timedPickup` (integer, required, min 0). Specifies timed pickup for this call.
      - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this call.
      - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this call.
      - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this call.
      - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this call.
      - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this call.
      - `shortAnswered` (integer, required, min 0). Specifies short answered for this call.
      - `video` (integer, required, min 0). Specifies video for this call.
      - `directions` (object, required). Structured directions values for this call.
        - `inbound` (object, required). Structured inbound values for this direction.
          - `total` (integer, required, min 0). Final total for this order or price summary.
          - `answered` (integer, required, min 0). Specifies answered for this inbound.
          - `missed` (integer, required, min 0). Specifies missed for this inbound.
          - `declined` (integer, required, min 0). Specifies declined for this inbound.
          - `failed` (integer, required, min 0). Specifies failed for this inbound.
          - `ringing` (integer, required, min 0). Specifies ringing for this inbound.
          - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this inbound.
          - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this inbound.
          - `timedAnswered` (integer, required, min 0). Specifies timed answered for this inbound.
          - `timedPickup` (integer, required, min 0). Specifies timed pickup for this inbound.
          - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this inbound.
          - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this inbound.
          - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this inbound.
          - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this inbound.
          - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this inbound.
          - `shortAnswered` (integer, required, min 0). Specifies short answered for this inbound.
          - `video` (integer, required, min 0). Specifies video for this inbound.
        - `outbound` (object, required). Structured outbound values for this direction.
          - `total` (integer, required, min 0). Final total for this order or price summary.
          - `answered` (integer, required, min 0). Specifies answered for this outbound.
          - `missed` (integer, required, min 0). Specifies missed for this outbound.
          - `declined` (integer, required, min 0). Specifies declined for this outbound.
          - `failed` (integer, required, min 0). Specifies failed for this outbound.
          - `ringing` (integer, required, min 0). Specifies ringing for this outbound.
          - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this outbound.
          - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this outbound.
          - `timedAnswered` (integer, required, min 0). Specifies timed answered for this outbound.
          - `timedPickup` (integer, required, min 0). Specifies timed pickup for this outbound.
          - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this outbound.
          - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this outbound.
          - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this outbound.
          - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this outbound.
          - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this outbound.
          - `shortAnswered` (integer, required, min 0). Specifies short answered for this outbound.
          - `video` (integer, required, min 0). Specifies video for this outbound.
      - `mediaQuality` (object, required). Structured media quality values for this call.
        - `measuredCalls` (integer, required, min 0). Specifies measured calls for this media quality.
        - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this media quality.
        - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this media quality.
        - `packetsLost` (integer, required, nullable, min 0). Specifies packets lost for this media quality.
      - `appQuality` (object, required). Structured app quality values for this call.
        - `measuredCalls` (integer, required, min 0). Specifies measured calls for this app quality.
        - `averageJitterMs` (number, required, nullable, min 0). Specifies average jitter ms for this app quality.
        - `averageRttMs` (number, required, nullable, min 0). Specifies average rtt ms for this app quality.
        - `packetLossRate` (number, required, nullable, range 0–1). Specifies packet loss rate for this app quality.
        - `reconnects` (integer, required, nullable, min 0). Specifies reconnects for this app quality.
      - `endReasons` (array of object, required). End reasons associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `appErrors` (array of object, required). App errors associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `transports` (array of object, required). Transports associated with this call.
        - `code` (string, required). Stable machine-readable code for this result.
        - `count` (integer, required, min 0). Number of matching resources.
      - `multiParticipantCalls` (integer, required, min 0). Specifies multi participant calls for this call.
      - `followUp` (object, required). Structured follow up values for this call.
        - `eligibleMissed` (integer, required, min 0). Specifies eligible missed for this follow up.
        - `returnedWithin24h` (integer, required, min 0). Specifies returned within24h for this follow up.
        - `rate` (number, required, nullable, range 0–1). Specifies rate for this follow up.
        - `averageDelayMs` (number, required, nullable, min 0). Specifies average delay ms for this follow up.
        - `pendingWindow` (integer, required, min 0). Specifies pending window for this follow up.
        - `unknownContact` (integer, required, min 0). Specifies unknown contact for this follow up.
    - `deviceAnalytics` (object, required). Observed message client-family distributions and a bounded inventory of this number's own devices. The combined summary has null inventory.
      - `detector` (string, required). Specifies detector for this device analytic. Values: `message_id_prefix/v1`.
      - `measured` (boolean, required). True when at least one retained bucket has client-family measurement coverage, including buckets with zero messages.
      - `complete` (boolean, required). True when measured is true, every retained bucket has device-family coverage and conversation receipt coverage is complete. False when coverage is missing or records, conversations or receipt joins were dropped. Inventory truncation is reported separately.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this device analytic.
      - `customerMessages` (integer, required, nullable, min 0). Specifies customer messages for this device analytic.
      - `accountMessages` (integer, required, nullable, min 0). Specifies account messages for this device analytic.
      - `customerPlatforms` (array of object, required). Customer platforms associated with this device analytic.
        - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `messages` (integer, required, min 0). Specifies messages for this customer platform.
        - `share` (number, required, nullable, range 0–1). Specifies share for this customer platform.
      - `accountPlatforms` (array of object, required). Account platforms associated with this device analytic.
        - `platform` (string, required). Sending client family estimated from a message ID prefix; not verified hardware or operating system. Values: `web` (Web client.), `android` (Android client.), `iphone` (iPhone client.), `ipad` (iPad client.), `macos` (macOS client.), `windows` (Windows client.), `wearable` (Wearable client.), `ar_device` (AR device client.), `unknown` (No recognized client-family prefix.).
        - `messages` (integer, required, min 0). Specifies messages for this account platform.
        - `share` (number, required, nullable, range 0–1). Specifies share for this account platform.
      - `inventory` (object, required, nullable). Structured inventory values for this device analytic.
        - `listObserved` (boolean, required). True after a full device list for this number was observed.
        - `listCurrent` (boolean, required). True when a full list was observed and no later list-change signal invalidated it. Membership and device count are unknown until another full list after a change.
        - `observedAt` (integer, required, nullable). Unix milliseconds.
        - `deviceCount` (integer, required, nullable, min 0). Number of devices.
        - `truncated` (boolean, required). True when the bounded inventory omitted devices. At most 25 device rows are returned; a current full-list device count can be larger.
        - `devices` (array of object, required, max items 25). Devices associated with this inventory.
    - `conversationBreakdown` (object, required). Completed 24-hour conversation cohorts grouped jointly by completion bucket, first outgoing message metadata, calling code and observed device-count class.
      - `measured` (boolean, required). True when at least one retained bucket includes joint conversation categories.
      - `complete` (boolean, required). True when measured is true, every retained bucket has joint conversation coverage, no conversation, record or receipt-join coverage was lost and the returned groups are not truncated. Rates and averages are null when false.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this conversation breakdown.
      - `droppedConversations` (integer, required, min 0). Specifies dropped conversations for this conversation breakdown.
      - `truncated` (boolean, required). True when the requested scope exceeded 4096 number/time/category groups. The largest groups are retained; rates and averages are null.
      - `buckets` (array of object, required). Buckets associated with this conversation breakdown.
        - `ts` (integer, required). Unix milliseconds.
        - `complete` (boolean, required). True when this UTC time bucket has joint category coverage and no conversations or records were dropped. A summary bucket also requires every scoped number to have a bucket.
      - `rows` (array of object, required, max items 4096). Rows associated with this conversation breakdown.
        - `ts` (integer, required). Unix milliseconds.
        - `messageType` (string, required). Category assigned to message. Values: `text`, `image`, `video`, `audio`, `document`, `sticker`, `interactive`, `template`, `other`.
        - `textBand` (string, required). Specifies text band for this row. Values: `none`, `short`, `medium`, `long`, `very_long`, `unknown`.
        - `origin` (string, required). Specifies origin for this row. Values: `api` (API send.), `campaign` (Campaign send.), `other` (Other or unclassified send source.).
        - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Numbering country inferred from a full phone number or valid BSUID prefix; Unknown for missing historical metadata. Not current location.
        - `recipientDeviceCount` (string, required). Observed linked-device range; device zero is the primary and is excluded from linked counts. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
        - `callingCode` (string, required, pattern ^(unknown|[1-9][0-9]{0,2})$). Machine-readable calling code for this row.
        - `customerDevices` (string, required). Specifies customer devices for this row. Values: `single`, `multiple`, `unknown`.
        - `completedConversations` (integer, required, min 0). Specifies completed conversations for this row.
        - `deliveredConversations` (integer, required, min 0). Specifies delivered conversations for this row.
        - `readConversations` (integer, required, min 0). Specifies read conversations for this row.
        - `repliedConversations` (integer, required, min 0). Specifies replied conversations for this row.
        - `replyLatencySumMs` (integer, required, min 0). Specifies reply latency sum ms for this row.
        - `readRate` (number, required, nullable, range 0–1). Specifies read rate for this row.
        - `replyRate` (number, required, nullable, range 0–1). Specifies reply rate for this row.
        - `averageCustomerReplyMs` (number, required, nullable, min 0). Specifies average customer reply ms for this row.
    - `recipientActivity` (object). Hourly aggregate recipient observations, grouped jointly by numbering country, observed linked-device count and sender-device class. Incoming messages and matched delivery/read receipts are deduplicated by native message and device in bounded memory. Presence is user-level and uses Unknown device source. Quiet gaps of at least 15 minutes are completed gaps between observed signals on the same device, never verified offline periods. No recipient identity, native message ID or recipient device index is retained. Coverage is explicit; older retained buckets are unmeasured. Message telemetry remains Linked Devices only; Official API message activity is not measured.
      - `measured` (boolean, required). Whether measured.
      - `complete` (boolean, required). Whether complete.
      - `observedBuckets` (integer, required, min 0). Specifies observed buckets for this recipient activity.
      - `droppedSignals` (integer, required, min 0). Specifies dropped signals for this recipient activity.
      - `truncated` (boolean, required). Whether truncated.
      - `rows` (array of object, required, max items 4096). Rows associated with this recipient activity.
        - `ts` (integer, required). Unix milliseconds.
        - `recipientCountry` (string, required, pattern ^(unknown|[A-Z]{2})$). Specifies recipient country for this row.
        - `recipientDeviceCount` (string, required). Number of recipient devices. Values: `primary_only`, `one_linked`, `two_plus_linked`, `unknown`.
        - `deviceSource` (string, required). Specifies device source for this row. Values: `primary`, `linked`, `unknown`.
        - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this row.
        - `deliveryReceipts` (integer, required, min 0). Specifies delivery receipts for this row.
        - `readReceipts` (integer, required, min 0). Specifies read receipts for this row.
        - `onlineSignals` (integer, required, min 0). Specifies online signals for this row.
        - `offlineSignals` (integer, required, min 0). Specifies offline signals for this row.
        - `typingSignals` (integer, required, min 0). Specifies typing signals for this row.
        - `lastSignalAt` (integer, required). Unix milliseconds.
        - `quietGaps` (integer, required, min 0). Specifies quiet gaps for this row.
        - `quietGapMs` (integer, required, min 0). Specifies quiet gap ms for this row.
        - `averageQuietGapMs` (number, required, nullable, min 0). Specifies average quiet gap ms for this row.
  - `series` (array of object, required). Series associated with this management whats app analytic.
    - `ts` (integer, required). Unix milliseconds.
    - `outgoingMessages` (integer, required, min 0). Specifies outgoing messages for this sery.
    - `incomingMessages` (integer, required, min 0). Specifies incoming messages for this sery.
    - `sendFailures` (integer, required, min 0). Specifies send failures for this sery.
    - `businessReplies` (integer, required, min 0). Specifies business replies for this sery.
    - `averageBusinessResponseMs` (number, required, nullable, min 0). Specifies average business response ms for this sery.
    - `onlineMs` (integer, required, min 0). Specifies online ms for this sery.
    - `disconnects` (integer, required, min 0). Specifies disconnects for this sery.
    - `sessionId` (string (uuid), required, format uuid). Identifier of the connected Polymorfa session.
    - `customerOnlineSignals` (integer, required, min 0). Specifies customer online signals for this sery.
    - `customerTypingSignals` (integer, required, min 0). Specifies customer typing signals for this sery.
    - `primaryPhoneMessages` (integer, required, min 0). Specifies primary phone messages for this sery.
    - `otherDeviceMessages` (integer, required, min 0). Specifies other device messages for this sery.
    - `primaryPhoneReplies` (integer, required, min 0). Specifies primary phone replies for this sery.
    - `phoneActivePeriods` (integer, required, min 0). Specifies phone active periods for this sery.
    - `completedPhoneActivityPeriods` (integer, required, min 0). Specifies completed phone activity periods for this sery.
    - `phoneActivityMs` (integer, required, min 0). Specifies phone activity ms for this sery.
    - `phoneQuietGaps` (integer, required, min 0). Specifies phone quiet gaps for this sery.
    - `phoneQuietMs` (integer, required, min 0). Specifies phone quiet ms for this sery.
  - `callSeries` (array of object, required). Call series associated with this management whats app analytic.
    - `total` (integer, required, min 0). Final total for this order or price summary.
    - `answered` (integer, required, min 0). Specifies answered for this call sery.
    - `missed` (integer, required, min 0). Specifies missed for this call sery.
    - `declined` (integer, required, min 0). Specifies declined for this call sery.
    - `failed` (integer, required, min 0). Specifies failed for this call sery.
    - `ringing` (integer, required, min 0). Specifies ringing for this call sery.
    - `answerRate` (number, required, nullable, range 0–1). Specifies answer rate for this call sery.
    - `talkSeconds` (integer, required, min 0). Specifies talk seconds for this call sery.
    - `timedAnswered` (integer, required, min 0). Specifies timed answered for this call sery.
    - `timedPickup` (integer, required, min 0). Specifies timed pickup for this call sery.
    - `averageTalkSeconds` (number, required, nullable, min 0). Specifies average talk seconds for this call sery.
    - `medianTalkSeconds` (number, required, nullable, min 0). Specifies median talk seconds for this call sery.
    - `p95TalkSeconds` (number, required, nullable, min 0). Specifies p95 talk seconds for this call sery.
    - `averagePickupMs` (number, required, nullable, min 0). Specifies average pickup ms for this call sery.
    - `p95PickupMs` (number, required, nullable, min 0). Specifies p95 pickup ms for this call sery.
    - `shortAnswered` (integer, required, min 0). Specifies short answered for this call sery.
    - `video` (integer, required, min 0). Specifies video for this call sery.
    - `sessionId` (string (uuid), required, format uuid). Identifier of the connected Polymorfa session.
    - `ts` (integer, required). Unix milliseconds.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "enabled": true,
    "period": {
      "start": 0,
      "end": 0
    },
    "requestVitals": {
      "requests": 0,
      "failures": 0,
      "errorRate": 0
    },
    "summary": {
      "measured": true,
      "observedHours": 0,
      "lastObservedAt": 0,
      "outgoingMessages": 0,
      "incomingMessages": 0,
      "sendAttempts": 0,
      "sendFailures": 0,
      "sendFailureRate": 0,
      "businessReplies": 0,
      "averageBusinessResponseMs": 0,
      "onlineMs": 0,
      "disconnects": 0,
      "connectFailures": 0,
      "streamErrors": 0,
      "keepaliveTimeouts": 0,
      "engagement": {
        "windowHours": 24,
        "completedConversations": 0,
        "deliveredConversations": 0,
        "readConversations": 0,
        "repliedConversations": 0,
        "deliveryRate": 0,
        "readRate": 0,
        "replyRate": 0,
        "averageCustomerReplyMs": 0,
        "complete": true,
        "droppedConversations": 0,
        "droppedRecords": 0,
        "droppedReceiptJoins": 0
      },
      "totalNumbers": 0,
      "measuredNumbers": 0,
      "connectedNumbers": 0,
      "messageAnalysis": {
        "complete": true,
        "segments": [
          {
            "dimension": "message_type",
            "key": "string",
            "sendAttempts": 0,
            "sent": 0,
            "sendFailures": 0,
            "sendFailureRate": 0,
            "completedConversations": 0,
            "deliveredConversations": 0,
            "readConversations": 0,
            "repliedConversations": 0,
            "deliveryRate": 0,
            "readRate": 0,
            "replyRate": 0,
            "averageCustomerReplyMs": 0,
            "shareOfConversations": 0,
            "shareOfSends": 0,
            "readRateInterval95": [
              null
            ],
            "replyRateInterval95": [
              null
            ],
            "readRateDifference": -1,
            "replyRateDifference": -1
          }
        ]
      },
      "customerActivity": {
        "observed": true,
        "onlineSignals": 0,
        "offlineSignals": 0,
        "typingSignals": 0
      },
      "accountActivity": {
        "observed": true,
        "primaryPhoneActivitySignals": 0,
        "primaryPhoneActivePeriods": 0,
        "completedPhoneActivityPeriods": 0,
        "phoneActivityMs": 0,
        "averagePhoneActivityMs": 0,
        "phoneQuietGaps": 0,
        "phoneQuietMs": 0,
        "averagePhoneQuietMs": 0,
        "primaryPhoneMessages": 0,
        "otherDeviceMessages": 0,
        "lastPrimaryPhoneAt": 0,
        "primaryPhoneReplies": 0,
        "otherDeviceReplies": 0,
        "averagePrimaryPhoneResponseMs": 0,
        "averageOtherDeviceResponseMs": 0
      },
      "responseQueue": {
        "awaitingReply": 0,
        "oldestWaitingMs": 0,
        "observedAt": 0,
        "complete": true
      },
      "calls": {
        "total": 0,
        "answered": 0,
        "missed": 0,
        "declined": 0,
        "failed": 0,
        "ringing": 0,
        "answerRate": 0,
        "talkSeconds": 0,
        "timedAnswered": 0,
        "timedPickup": 0,
        "averageTalkSeconds": 0,
        "medianTalkSeconds": 0,
        "p95TalkSeconds": 0,
        "averagePickupMs": 0,
        "p95PickupMs": 0,
        "shortAnswered": 0,
        "video": 0,
        "directions": {
          "inbound": {
            "total": 0,
            "answered": 0,
            "missed": 0,
            "declined": 0,
            "failed": 0,
            "ringing": 0,
            "answerRate": 0,
            "talkSeconds": 0,
            "timedAnswered": 0,
            "timedPickup": 0,
            "averageTalkSeconds": 0,
            "medianTalkSeconds": 0,
            "p95TalkSeconds": 0,
            "averagePickupMs": 0,
            "p95PickupMs": 0,
            "shortAnswered": 0,
            "video": 0
          },
          "outbound": {
            "total": 0,
            "answered": 0,
            "missed": 0,
            "declined": 0,
            "failed": 0,
            "ringing": 0,
            "answerRate": 0,
            "talkSeconds": 0,
            "timedAnswered": 0,
            "timedPickup": 0,
            "averageTalkSeconds": 0,
            "medianTalkSeconds": 0,
            "p95TalkSeconds": 0,
            "averagePickupMs": 0,
            "p95PickupMs": 0,
            "shortAnswered": 0,
            "video": 0
          }
        },
        "mediaQuality": {
          "measuredCalls": 0,
          "averageJitterMs": 0,
          "averageRttMs": 0,
          "packetsLost": 0
        },
        "appQuality": {
          "measuredCalls": 0,
          "averageJitterMs": 0,
          "averageRttMs": 0,
          "packetLossRate": 0,
          "reconnects": 0
        },
        "endReasons": [
          {
            "code": "string",
            "count": 0
          }
        ],
        "appErrors": [
          {
            "code": "string",
            "count": 0
          }
        ],
        "transports": [
          {
            "code": "string",
            "count": 0
          }
        ],
        "multiParticipantCalls": 0,
        "followUp": {
          "eligibleMissed": 0,
          "returnedWithin24h": 0,
          "rate": 0,
          "averageDelayMs": 0,
          "pendingWindow": 0,
          "unknownContact": 0
        }
      },
      "deviceAnalytics": {
        "detector": "message_id_prefix/v1",
        "measured": true,
        "complete": true,
        "observedBuckets": 0,
        "customerMessages": 0,
        "accountMessages": 0,
        "customerPlatforms": [
          {
            "platform": "web",
            "messages": 0,
            "share": 0
          }
        ],
        "accountPlatforms": [
          {
            "platform": "web",
            "messages": 0,
            "share": 0
          }
        ],
        "inventory": {
          "listObserved": true,
          "listCurrent": true,
          "observedAt": 0,
          "deviceCount": 0,
          "truncated": true,
          "devices": [
            {
              "deviceIndex": null,
              "estimatedPlatform": "web",
              "reportedClass": "phone",
              "lastActiveAt": null,
              "listed": null
            }
          ]
        }
      },
      "conversationBreakdown": {
        "measured": true,
        "complete": true,
        "observedBuckets": 0,
        "droppedConversations": 0,
        "truncated": true,
        "buckets": [
          {
            "ts": 0,
            "complete": true
          }
        ],
        "rows": [
          {
            "ts": 0,
            "messageType": "text",
            "textBand": "none",
            "origin": "api",
            "recipientCountry": "string",
            "recipientDeviceCount": "primary_only",
            "callingCode": "string",
            "customerDevices": "single",
            "completedConversations": 0,
            "deliveredConversations": 0,
            "readConversations": 0,
            "repliedConversations": 0,
            "replyLatencySumMs": 0,
            "readRate": 0,
            "replyRate": 0,
            "averageCustomerReplyMs": 0
          }
        ]
      }
    },
    "numbers": [
      {
        "sessionId": "00000000-0000-4000-8000-000000000000",
        "projectId": "00000000-0000-4000-8000-000000000000",
        "name": "string",
        "backend": "string",
        "status": "string",
        "measured": true,
        "observedHours": 0,
        "lastObservedAt": 0,
        "outgoingMessages": 0,
        "incomingMessages": 0,
        "sendAttempts": 0,
        "sendFailures": 0,
        "sendFailureRate": 0,
        "businessReplies": 0,
        "averageBusinessResponseMs": 0,
        "onlineMs": 0,
        "disconnects": 0,
        "connectFailures": 0,
        "streamErrors": 0,
        "keepaliveTimeouts": 0,
        "engagement": {
          "windowHours": 24,
          "completedConversations": 0,
          "deliveredConversations": 0,
          "readConversations": 0,
          "repliedConversations": 0,
          "deliveryRate": 0,
          "readRate": 0,
          "replyRate": 0,
          "averageCustomerReplyMs": 0,
          "complete": true,
          "droppedConversations": 0,
          "droppedRecords": 0,
          "droppedReceiptJoins": 0
        },
        "messageAnalysis": {
          "complete": true,
          "segments": [
            {
              "dimension": "message_type",
              "key": null,
              "sendAttempts": null,
              "sent": null,
              "sendFailures": null,
              "sendFailureRate": null,
              "completedConversations": null,
              "deliveredConversations": null,
              "readConversations": null,
              "repliedConversations": null,
              "deliveryRate": null,
              "readRate": null,
              "replyRate": null,
              "averageCustomerReplyMs": null,
              "shareOfConversations": null,
              "shareOfSends": null,
              "readRateInterval95": null,
              "replyRateInterval95": null,
              "readRateDifference": null,
              "replyRateDifference": null
            }
          ]
        },
        "customerActivity": {
          "observed": true,
          "onlineSignals": 0,
          "offlineSignals": 0,
          "typingSignals": 0
        },
        "accountActivity": {
          "observed": true,
          "primaryPhoneActivitySignals": 0,
          "primaryPhoneActivePeriods": 0,
          "completedPhoneActivityPeriods": 0,
          "phoneActivityMs": 0,
          "averagePhoneActivityMs": 0,
          "phoneQuietGaps": 0,
          "phoneQuietMs": 0,
          "averagePhoneQuietMs": 0,
          "primaryPhoneMessages": 0,
          "otherDeviceMessages": 0,
          "lastPrimaryPhoneAt": 0,
          "primaryPhoneReplies": 0,
          "otherDeviceReplies": 0,
          "averagePrimaryPhoneResponseMs": 0,
          "averageOtherDeviceResponseMs": 0
        },
        "responseQueue": {
          "awaitingReply": 0,
          "oldestWaitingMs": 0,
          "observedAt": 0,
          "complete": true
        },
        "projectName": "string",
        "calls": {
          "total": 0,
          "answered": 0,
          "missed": 0,
          "declined": 0,
          "failed": 0,
          "ringing": 0,
          "answerRate": 0,
          "talkSeconds": 0,
          "timedAnswered": 0,
          "timedPickup": 0,
          "averageTalkSeconds": 0,
          "medianTalkSeconds": 0,
          "p95TalkSeconds": 0,
          "averagePickupMs": 0,
          "p95PickupMs": 0,
          "shortAnswered": 0,
          "video": 0,
          "directions": {
            "inbound": {
              "total": null,
              "answered": null,
              "missed": null,
              "declined": null,
              "failed": null,
              "ringing": null,
              "answerRate": null,
              "talkSeconds": null,
              "timedAnswered": null,
              "timedPickup": null,
              "averageTalkSeconds": null,
              "medianTalkSeconds": null,
              "p95TalkSeconds": null,
              "averagePickupMs": null,
              "p95PickupMs": null,
              "shortAnswered": null,
              "video": null
            },
            "outbound": {
              "total": null,
              "answered": null,
              "missed": null,
              "declined": null,
              "failed": null,
              "ringing": null,
              "answerRate": null,
              "talkSeconds": null,
              "timedAnswered": null,
              "timedPickup": null,
              "averageTalkSeconds": null,
              "medianTalkSeconds": null,
              "p95TalkSeconds": null,
              "averagePickupMs": null,
              "p95PickupMs": null,
              "shortAnswered": null,
              "video": null
            }
          },
          "mediaQuality": {
            "measuredCalls": 0,
            "averageJitterMs": 0,
            "averageRttMs": 0,
            "packetsLost": 0
          },
          "appQuality": {
            "measuredCalls": 0,
            "averageJitterMs": 0,
            "averageRttMs": 0,
            "packetLossRate": 0,
            "reconnects": 0
          },
          "endReasons": [
            {
              "code": null,
              "count": null
            }
          ],
          "appErrors": [
            {
              "code": null,
              "count": null
            }
          ],
          "transports": [
            {
              "code": null,
              "count": null
            }
          ],
          "multiParticipantCalls": 0,
          "followUp": {
            "eligibleMissed": 0,
            "returnedWithin24h": 0,
            "rate": 0,
            "averageDelayMs": 0,
            "pendingWindow": 0,
            "unknownContact": 0
          }
        },
        "deviceAnalytics": {
          "detector": "message_id_prefix/v1",
          "measured": true,
          "complete": true,
          "observedBuckets": 0,
          "customerMessages": 0,
          "accountMessages": 0,
          "customerPlatforms": [
            {
              "platform": "web",
              "messages": null,
              "share": null
            }
          ],
          "accountPlatforms": [
            {
              "platform": "web",
              "messages": null,
              "share": null
            }
          ],
          "inventory": {
            "listObserved": true,
            "listCurrent": true,
            "observedAt": 0,
            "deviceCount": 0,
            "truncated": true,
            "devices": [
              null
            ]
          }
        },
        "conversationBreakdown": {
          "measured": true,
          "complete": true,
          "observedBuckets": 0,
          "droppedConversations": 0,
          "truncated": true,
          "buckets": [
            {
              "ts": null,
              "complete": null
            }
          ],
          "rows": [
            {
              "ts": null,
              "messageType": "text",
              "textBand": "none",
              "origin": "api",
              "recipientCountry": null,
              "recipientDeviceCount": "primary_only",
              "callingCode": null,
              "customerDevices": "single",
              "completedConversations": null,
              "deliveredConversations": null,
              "readConversations": null,
              "repliedConversations": null,
              "replyLatencySumMs": null,
              "readRate": null,
              "replyRate": null,
              "averageCustomerReplyMs": null
            }
          ]
        }
      }
    ],
    "series": [
      {
        "ts": 0,
        "outgoingMessages": 0,
        "incomingMessages": 0,
        "sendFailures": 0,
        "businessReplies": 0,
        "averageBusinessResponseMs": 0,
        "onlineMs": 0,
        "disconnects": 0,
        "sessionId": "00000000-0000-4000-8000-000000000000",
        "customerOnlineSignals": 0,
        "customerTypingSignals": 0,
        "primaryPhoneMessages": 0,
        "otherDeviceMessages": 0,
        "primaryPhoneReplies": 0,
        "phoneActivePeriods": 0,
        "completedPhoneActivityPeriods": 0,
        "phoneActivityMs": 0,
        "phoneQuietGaps": 0,
        "phoneQuietMs": 0
      }
    ],
    "callSeries": [
      {
        "total": 0,
        "answered": 0,
        "missed": 0,
        "declined": 0,
        "failed": 0,
        "ringing": 0,
        "answerRate": 0,
        "talkSeconds": 0,
        "timedAnswered": 0,
        "timedPickup": 0,
        "averageTalkSeconds": 0,
        "medianTalkSeconds": 0,
        "p95TalkSeconds": 0,
        "averagePickupMs": 0,
        "p95PickupMs": 0,
        "shortAnswered": 0,
        "video": 0,
        "sessionId": "00000000-0000-4000-8000-000000000000",
        "ts": 0
      }
    ]
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

#### 503

The change was stored, but a connected number has not confirmed it. Retry the request; the stored setting is already correct and is retried automatically.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "api_error",
    "code": "service_unavailable",
    "message": "A required service is unavailable. Check completion before repeating a write.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#service-unavailable"
}
```
