---
title: "Fetch usage for a single stream target"
method: GET
path: "/usage/stream_targets/{id}"
tags: ["usage"]
---

# Fetch usage for a single stream target

`GET /usage/stream_targets/{id}`

(Available from version 1.4) This operation returns CDN usage details for a specific stream target. Defaults: from = last billing date, to = end of current day.

## Path parameters

- `id` string, required

## Query parameters

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

## Response `200`

Success

- UsageStreamTarget
  - `stream_target` object
    - `id` string, int32 — The unique alphanumeric string that identifies the stream target.
    - `name` string — A descriptive name for the stream target. Maximum 255 characters.
    - `archived` boolean — A value of **true** indicates that the stream target has been removed from Wowza Video.
    - `type` 'fastly' — The type of stream target. <br/> **fastly** is a Wowza CDN on Fastly target.
    - `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 stream target 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.
    - `zones` object — A hash of zones with CDN usage, keyed by the name of the billing zone where the usage was generated.
      - `name` string — The name of the billing zone where the usage was generated.
      - `viewing_bytes` integer — The amount of content, in bytes, that went through the stream target during the selected time frame.
      - `type` 'fastly' — The type of stream target. <br/> **fastly** is a Wowza CDN on Fastly target.
  - `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)