---
title: "Transaction QoS"
method: POST
path: "/transactions/qos"
tags: ["Transactions"]
---

# Transaction QoS

`POST /transactions/qos`

## Request body

- TransactionSessionRequest — Use session_id for one Call-ID, or session_ids (non-empty, max 50) for an OR filter across sessions. When session_ids is set it takes precedence over session_id. Supported on messages, qos, logs, callinfo, events, sub, hepsub, and export endpoints; responses include session_id on rows for grouping. For SIP call (proto_type=1, event_type=call), POST /transactions/callinfo returns one summary object per Call-ID (ringing_seconds, call_duration_seconds, codecs, UAC/UAS, setup delays, status, from_party, ruri_party, methods_distribution for the legacy methods chart, etc.).
  - `session_id` string — Session identifier to lookup messages/logs/QoS.
  - `session_ids` string[] — Multiple Call-IDs (OR filter; B2B leg matching where applicable).
  - `proto_type` integer — HEP protocol type (default 1).
  - `event_type` string — Event type (call, registration, default).
  - `timestamp` object — Optional millisecond UTC window (from/to).
    - `from` integer
    - `to` integer
  - `whitelist` string[] — IPs to exclude from PCAP/text export only (legacy Homer 7 field name; not an allow-list). A row is omitted when src_ip or dst_ip equals any listed address.

## Response `200`

QoS

- QosResponse
  - `data` SearchTransactionQos
    - `rtcp` SearchTransactionRtcpList
      - `data` SearchTransactionRtcp[]
        - `id` number
        - `sid` string
        - `dst_ip` string
        - `src_ip` string
        - `dst_port` number
        - `src_port` number
        - `payload_type` integer
        - `micro_ts` integer
    - `rtp` SearchTransactionRtpList
      - `data` SearchTransactionRtp[]
        - `id` number
        - `sid` string
        - `dst_ip` string
        - `src_ip` string
        - `dst_port` number
        - `src_port` number
        - `payload_type` integer
        - `micro_ts` integer
  - `meta` Meta
    - `request_id` string
    - `trace_id` string
    - `pagination` Pagination
      - `limit` integer
      - `next_cursor` string
      - `prev_cursor` string
      - `total` integer
      - `has_more` boolean
    - `message` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Server error

---

[API](https://skmtc.net/sipcapture/apis/homer-next-gen-api.md) · [All operations](https://skmtc.net/sipcapture/apis/homer-next-gen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sipcapture/homer-next-gen-api/versions/1966dd0df318/schema)