# Fetch usage for all 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. Endpoint: GET /usage/transcoders Version: v2.0 ## Query parameters: - `from` (string) The start of the range of time you want to view. Specify YYYY-MM-DD HH:00:00 where HH is a 24-hour clock in UTC. The range doesn't include minutes and seconds and rounds minutes up to the hour. The maximum difference between from and to is 90 days. If you set the from query parameter without setting the to query parameter, the data returned will reflect 90 days starting at the from date, or data up to to the current day, whichever is shorter. You can also specify last_bill_date. Default: last billing date - `to` (string) The end of the range of time you want to view. Specify YYYY-MM-DD HH:00:00 where HH is a 24-hour clock in UTC. The range doesn't include minutes and seconds and rounds minutes up to the hour. The maximum difference between from and to is 90 days. If you set the to query parameter without setting the from query parameter, the data returned will be from the past 90 days or from your last invoice date, whichever is shorter. You can also specify last_bill_date. Default: end of the current day - `page` (integer) Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is 1. For more information and examples, see Get paginated query results with the Wowza Video REST API. - `per_page` (integer) For use with the page parameter. Indicates how many records should be included in a page of results. A valid value is any positive integer. The default and maximum value is 1000. ## Response 200 fields (application/json): - `transcoders` (object) Example: [{"id":"bbrjj3ml","name":"transcoder name","archived":false,"transcoder_type":"transcoded","billing_mode":"pay_as_you_go","egress_bytes":0,"egress_seconds":44,"egress_seconds_additional_targets":23},{"id":"mertj8nd","name":"my other transcoder","archived":false,"transcoder_type":"transcoded","billing_mode":"pay_as_you_go","egress_bytes":80384481,"egress_seconds":158,"egress_seconds_additional_targets":0}] - `transcoders.id` (integer) The unique alphanumeric string that identifies the transcoder. - `transcoders.name` (string) A descriptive name for the transcoder. - `transcoders.archived` (boolean) A value of true indicates that the transcoder has been removed from Wowza Video. - `transcoders.billing_mode` (string) 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. Enum: "pay_as_you_go", "twentyfour_seven" - `transcoders.transcoder_type` (string) The type of transcoder. The default is transcoded. Enum: "transcoded", "passthrough" - `transcoders.egress_bytes` (integer) The amount of content, in bytes, that went through the transcoder during the selected time frame. - `transcoders.egress_seconds` (integer) The amount of time, in seconds, that it took for the stream to be processed. - `transcoders.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. Example: {"payload_version":"1.0","total_records":2130,"page":3,"per_page":3,"total_pages":710,"page_first_index":6,"page_last_index":8} - `pagination.payload_version` (integer) The pagination object version. Example: "1.0" - `pagination.total_records` (integer) The total number of records in the database that match the query. Example: 2130 - `pagination.page` (integer) The page being displayed. Example: 3 - `pagination.per_page` (integer) The number of records included on each page of results. Example: 3 - `pagination.total_pages` (integer) The total number of pages generated by the query. Example: 710 - `pagination.page_first_index` (integer) The 0-based index of the first record on the page returned. Example: 6 - `pagination.page_last_index` (integer) The 0-based index of the last record on the page returned. Example: 8 - `limits` (object) The time frame represented in the response. Example: {"from":"2019-10-01T07:00:00.000Z","to":"2019-10-16T11:00:00.000Z"} - `limits.from` (string) The start of the range of time represented in the response. Example: "2019-10-01T07:00:00.000Z" - `limits.to` (string) The end of the range of time represented in the response. Example: "2019-10-16T11:00:00.000Z" ## Response 401 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array) ## Response 403 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array) ## Response 404 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array) ## Response 410 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array) ## Response 422 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array)