# Plex API item played?

**URL:** <https://forums.plex.tv/t/plex-api-item-played/20016>\
**Category:** Dev/API Corner\
**Tags:** other-dev\
**Created:** [August 10, 2012, 7:40pm UTC](https://forums.plex.tv/t/plex-api-item-played/20016 "2012-08-10T19:40:45Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![tester22](https://avatars.discourse-cdn.com/v4/letter/t/f9ae1b/32.png) [@tester22](https://forums.plex.tv/u/tester22)\
**Post date:** [August 10, 2012, 7:40pm UTC](https://forums.plex.tv/t/plex-api-item-played/20016/1 "2012-08-10T19:40:45Z")

</div>

Hi, was trying to find out the best way to figure out if an item is played or not via the XML API from the section view eg: [http://127.0.0.1:32400/library/sections/1/all](http://127.0.0.1:32400/library/sections/1/all)  
  
There is a viewcount segment but that could have a value even if the item is marked as not played in the client.   
  
  
  
SO what is the best way to find out if an item is played?  
  
Should I use playcount or duration or something else?  
  
  
  
Any help is appreciated.

---

<div class="post-metadata">

**Author:** ![elan](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/elan/32/5_2.png) [@elan](https://forums.plex.tv/u/elan)\
**Post date:** [August 15, 2012, 2:44am UTC](https://forums.plex.tv/t/plex-api-item-played/20016/2 "2012-08-15T02:44:19Z")

</div>

There is viewCount and viewOffset. If viewCount \> 0, the item has been watched; however if viewCount \> 1 and viewOffset \> 0, it’s been watched, but is viewed as “in progress” again.

---

<div class="post-metadata">

**Author:** ![system](https://global.discourse-cdn.com/plex/original/3X/2/a/2acb9765406f63293d357b4ec509ec39aa28f2ad.png) [@system](https://forums.plex.tv/u/system)\
**Post date:** [December 20, 2019, 10:08pm UTC](https://forums.plex.tv/t/plex-api-item-played/20016/3 "2019-12-20T22:08:43Z")

</div>

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.