---
title: "Fetch usage for a single transcoder"
method: GET
path: "/usage/transcoders/{id}"
tags: ["usage_transcoders"]
---

# Fetch usage for a single transcoder

`GET /usage/transcoders/{id}`

(Available from version 1.4) This operation shows the amount of usage (egress) for a specific transcoder. The default time frame is *from* the last billing date *to* the end of the current day.

## Path parameters

- `id` string, required

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `include` string

## Response `200`

Success

- UsageTranscoder
  - `transcoders` object
    - `id` integer — The unique alphanumeric string that identifies the transcoder.
    - `name` string — A descriptive name for the transcoder.
    - `archived` boolean — A value of **true** indicates that the transcoder has been removed from Wowza Video.
    - `billing_mode` 'pay_as_you_go' | 'twentyfour_seven' — The billing mode for the transcoder. The default is **pay_as_you_go**. **pay_as_you_go** — Billed as a single event. A single event is use-based and you incur charges for the time spent streaming. **twentyfour_seven** — Billed as a 24x7 channel. A 24x7 channel is unlimited stream time for one channel. This billing mode doesn't incur overages, since it's unlimited.
    - `transcoder_type` 'transcoded' | 'passthrough' — The type of transcoder. The default is **transcoded**.
    - `egress_bytes` integer — The amount of content, in bytes, that went through the transcoder during the selected time frame.
    - `egress_seconds` integer — The amount of time, in seconds, that it took for the stream to be processed.
    - `egress_seconds_additional_targets` integer — The length of time, in seconds, that additional stream targets pulled from storage during the selected time frame. Subscriptions prices include egress for one target; additional targets incur additional charges.
    - `viewing_seconds` integer — The total length of time, in seconds, that the stream was played at the target. May be longer than the duration of the stream.
    - `viewing_bytes` integer — The amount of content, in bytes, that went through the transcoder during the selected time frame.
    - `trend` object — An array of viewer trend data. The granularity of sampled data changes based on the from and to query values you use: Requests made for data within the past 30 days, return the following sample intervals: <ul><li>0 minutes to 3 hours - Samples returned per minute</li> <li>3 hours, 1 second to 24 hours - Samples returned per hour</li> <li>24 hours, 1 second to 90 days - Samples returned per day</li></ul> <strong>Defaults</strong>: from = last billing date, to = end of current day
      - `sampled_at` string, date-time — The date and time the trend data was sampled.
      - `viewing_seconds` integer — The total length of time, in seconds, that the stream was played at the target. May be longer than the duration of the stream.
      - `viewing_bytes` integer — The amount of content, in bytes, that went through the transcoder during the selected time frame.
  - `limits` object — The time frame represented in the response.
    - `from` string, date-time — The start of the range of time represented in the response.
    - `to` string, date-time — The end of the range of time represented in the response.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `410` — Gone
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation.md) · [All operations](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wowza/wowza-video-rest-api-reference-documentation/revisions/157b6f741f2a/schema)