> For the complete documentation index, see [llms.txt](https://docs.mediamelon.com/mediamelon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mediamelon.com/mediamelon/smartsight-apis/errors-deprecated-page.md).

# Errors - Deprecated Page

The structure of the API is as follows

<mark style="color:blue;">`GET`</mark> `https://smartsight2.mediamelon.com/mm-apis/error/{customer-id}`

```
//Example
https://smartsight2.mediamelon.com/mm-apis/error/
<Customer ID>?period=start%3D<start epoch time stamp in mS> ,end%3D
<end epoch time stamp in mS>
&metrics=<error dimensions>
&dimension=error
&agg=1                 // For aggregtation
&aggby=<dimensionname> // Group by dimensions
&filter=<expression>   
```

An example would be&#x20;

```
// Example API call

https://smartsight.mediamelon.com/mm-apis/error/159268936?planlevel=2735
&metrics=videoid,key,category,errors
&dimension=error  // to be given for error analytics
&agg=1&period=start=1717085458,end=171717185
8&aggby=videoid,key,category
&offset=0
&limit=10
&filter=videoid=97542

// Sample Response
{
    "totalcount": 10,
    "pagecount": 24,
    "response": [
        {
            "videoid": "97542",
            "key": "PLAYLIST_ERROR",
            "category": "IN_STREAM_FATAL",
            "errors": 162,
            "totalpages": 24
        },
        {
            "videoid": "97542",
            "key": "AD_TAG_ERROR",
            "category": "AD_FATAL",
            "errors": 5,
            "totalpages": 24
        },
        {
            "videoid": "97542",
            "key": "AD_INVALID_ERROR",
            "category": "AD_FATAL",
            "errors": 5,
            "totalpages": 24
        },
        {
            "videoid": "97542",
            "key": "AD_PARSE_ERROR",
            "category": "AD_FATAL",
            "errors": 4,
            "totalpages": 24
        },
        {
            "videoid": "97542",
            "key": "AD_INCOMPATIBLE_ERROR",
            "category": "AD_FATAL",
            "errors": 1,
            "totalpages": 24
        },
        {
            "videoid": "97542",
            "key": "AD_NETWORK_TIMEOUT_ERROR",
            "category": "AD_ERROR",
            "errors": 9,
            "totalpages": 24
        },
        {
            "videoid": "97542",
            "key": "AD_REPLACEMENT_ERROR",
            "category": "AD_FATAL",
            "errors": 6,
            "totalpages": 24
        },
        {
            "videoid": "97542",
            "key": "AD_VPAID_CREATIVE_ERROR",
            "category": "AD_FATAL",
            "errors": 3,
            "totalpages": 24
        },
        {
            "videoid": "97542",
            "key": "AD_VAST_ERROR",
            "category": "AD_FATAL",
            "errors": 27,
            "totalpages": 24
        },
        {
            "videoid": "97542",
            "key": "AD_INCOMPATIBLE_CREATIVE_ERROR",
            "category": "AD_FATAL",
            "errors": 4,
            "totalpages": 24
        }
    ]
}


```

Error Metrics

| Metric Name   | Description                          |
| ------------- | ------------------------------------ |
| errors        | Total number of errors               |
| users         | Total number  of unique users        |
| concurviewavg | Number of distinct sessions affected |

Error Dimensions

<table><thead><tr><th width="370">Dimension </th><th>Description</th></tr></thead><tbody><tr><td>category</td><td>Error category</td></tr><tr><td>player</td><td>Player Name</td></tr><tr><td>device</td><td>Device Name</td></tr><tr><td>platform</td><td>OS Name</td></tr><tr><td>cdn</td><td>CDN Name</td></tr><tr><td>adserver</td><td>AD Server</td></tr><tr><td>adposition</td><td>Position of the ad POD where the error occurs ( only ad errors )</td></tr><tr><td>assetId</td><td>Asset ID</td></tr><tr><td>assetName</td><td>Asset Name</td></tr><tr><td>episodeNumber</td><td>Episode Number</td></tr><tr><td>season</td><td>Season Number</td></tr><tr><td>seriesTitle</td><td>Series Title</td></tr><tr><td>domainName</td><td>Domain Name</td></tr><tr><td>subscriberid</td><td>Subscriber ID</td></tr><tr><td>sessionid</td><td>Session ID</td></tr><tr><td>ipaddress</td><td>IP Address</td></tr><tr><td>streamURL</td><td>Stream URL</td></tr><tr><td>videoID</td><td>Video ID</td></tr></tbody></table>