---
title: "Fetch usage for all transcoders"
method: GET
path: "/usage/transcoders"
tags: ["usage_transcoders"]
---

# Fetch usage for all transcoders

`GET /usage/transcoders`

This operation shows the amount of usage (egress) for all transcoders in the account. The default time frame is *from* the last billing date *to* the end of the current day.

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `page` integer
- `per_page` integer

## Response `200`

Success

- UsageTranscoders
  - `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.
  - `pagination` object — Page information for the results generated by the query.
    - `payload_version` integer — The pagination object version.
    - `total_records` integer — The total number of records in the database that match the query.
    - `page` integer — The page being displayed.
    - `per_page` integer — The number of records included on each page of results.
    - `total_pages` integer — The total number of pages generated by the query.
    - `page_first_index` integer — The 0-based index of the first record on the page returned.
    - `page_last_index` integer — The 0-based index of the last record on the page returned.
  - `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)
