V3 > Statistics

Consumption.

Get the consumption for the provided subject, subject may be either a channel or a media, if anything else is provided, a 404 error will be raised.

get/2/vod/statistics/{subject}/consumption

Path parameters

subjectstring required

The Sequence unique identifier

Query parameters

formatstring nullable

Any valid byte unit, with or without precision specified (tries to format bytes in the most readable unit if nothing is specified):<br/><note><strong>YB</strong>: Yotta Byte</note><note><strong>ZB</strong>: Zetta Byte</note><note><strong>EB</strong>: Exa Byte</note><note><strong>PB</strong>: Peta Byte</note><note><strong>TB</strong>: Tera Byte</note><note><strong>GB</strong>: Giga Byte</note><note><strong>MB</strong>: Mega Byte</note><note><strong>kB</strong>: Kilo Byte</note><note><strong>B</strong>: Byte</note><note><strong>no</strong>: No formatting (raw number of bytes)</note>A precision (digits after '.') may be added with the following notation:<br/><note><strong>6</strong>: 1.322123MB</note><note><strong>/6</strong>: 1.322123MB</note><note><strong>MB/6</strong>: 1.322123MB</note><note><strong>MB/000000</strong>: 1.322123MB</note><note><strong>GB/9</strong>: 0.001322123GB</note>

Example:MB/6
fromstring nullable

<note><strong>Date</strong>: any accepted <a href="https://www.php.net/manual/fr/datetime.formats.date.php" target="_blank">PHP date format</a></note> <note><strong>Timestamp</strong>: a Timestamp</note> <note><strong>Time interval</strong>: a positive or negative interval with pattern: <pre>/+|-\d+[YyMdhims]/</pre>

<table> <thead> <tr> <td>symbol</td> <td>description</td> </tr> </thead> <tbody> <tr> <td>Y|y</td> <td>Year</td> </tr> <tr> <td>M</td> <td>Month</td> </tr> <tr> <td>d</td> <td>Day</td> </tr> <tr> <td>h</td> <td>Hour</td> </tr> <tr> <td>i|m</td> <td>Minute</td> </tr> <tr> <td>s</td> <td>Second</td> </tr> </tbody> </table> </note>
Example:+10d
tostring nullable

<note><strong>Date</strong>: any accepted <a href="https://www.php.net/manual/fr/datetime.formats.date.php" target="_blank">PHP date format</a></note> <note><strong>Timestamp</strong>: a Timestamp</note> <note><strong>Time interval</strong>: a positive or negative interval with pattern: <pre>/+|-\d+[YyMdhims]/</pre>

<table> <thead> <tr> <td>symbol</td> <td>description</td> </tr> </thead> <tbody> <tr> <td>Y|y</td> <td>Year</td> </tr> <tr> <td>M</td> <td>Month</td> </tr> <tr> <td>d</td> <td>Day</td> </tr> <tr> <td>h</td> <td>Hour</td> </tr> <tr> <td>i|m</td> <td>Minute</td> </tr> <tr> <td>s</td> <td>Second</td> </tr> </tbody> </table> </note>
Example:+10d
topinteger nullable

Limit the response size to the top N results.

Response

OK

result'success' | 'error' | 'asynchronous' required

Result of the HTTP request

Example response

{
  "result": "success"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.