---
title: "Get viewer video playhead(s)"
method: GET
path: "/accounts/{{account_id}}/playheads/{viewer_id}/{{video_id}}"
tags: ["Cross-Device Resume (XDR)"]
---

# Get viewer video playhead(s)

`GET /accounts/{{account_id}}/playheads/{viewer_id}/{{video_id}}`

## Request

- Base URL: `https://data.brightcove.com/v1/xdr`
- URL: `https://data.brightcove.com/v1/xdr/accounts/{{account_id}}/playheads/{viewer_id}/{{video_id}}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://oauth.brightcove.com/v4/access_token` scopes: `video-cloud/xdr/read`

Get the playhead(s) for all specified videos for a viewer

## Path parameters

- `account_id` string, required
- `viewer_id` string, required
- `video_id` string, required

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Response `200`

200

- PlayheadsResponse
  - `account_id` string
  - `viewer_id` string
  - `size` integer
  - `items` object[]
    - `video_id` string
    - `timestamp` integer
    - `playhead_seconds` integer

## Other responses

- `403`: Forbidden
- `500`: Server error

## Changes

- **2023-03-26** `b4d613a1c481`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brightcovelearning/apis/cross-device-resume-xdr-api-reference/changes/accounts/:{account_id}/playheads/:viewer_id/:{video_id}/get.md)

---

[API](https://skmtc.dev/brightcovelearning/apis/cross-device-resume-xdr-api-reference.md) - [All operations](https://skmtc.dev/brightcovelearning/apis/cross-device-resume-xdr-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/brightcovelearning/apis/cross-device-resume-xdr-api-reference/revisions/b4d613a1c481?raw)