Get session details

Available in Classic and VPC

Get details about a user's session using the player.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
GET	/v1/sessionRecent/{Session UUID}

Request headers

For information about the headers common to all Video Player Enhancement APIs, see Video Player Enhancement request headers.

Request query parameters

You can use the following query parameters with your request:

Field	Type	Required	Description
`Session UUID`	String	Required	Unique user ID UUID format

Request example

The request example is as follows:

curl --location --request GET 'https://ma-dashboard-api.vpe.naverncp.com/v1/sessionRecent/{Session UUID}' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project id}'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field	Type	Required	Description
`code`	String	-	Response code
`message`	String	-	Response message
`result`	Array	-	Session information

`result`

The following describes result.

Field	Type	Required	Description
`startTime`	Array	-	Time taken until playback start
`user`	Array	-	Session user information
`player`	Array	-	Player Information
`error`	Array	-	Error information
`sessionLog`	Array	-	Session log (player action cycle log)
`media`	Array	-	Playback source information

`startTime`

The following describes startTime.

Field	Type	Required	Description
`playerStartTimeSum`	Integer	-	Player preparation time (second)
`videoStartTimeSum`	Integer	-	Playback start time (second)
`totalStartTimeSum`	Integer	-	Total playback time (second)

`user`

The following describes user.

Field	Type	Required	Description
`os`	String	-	Operating system information
`isp`	String	-	Network information
`nation`	String	-	Country information
`address`	String	-	Position information
`browser`	String	-	Browser information
`ip`	String	-	IP address
`device`	String	-	Player playback environment `PC,Mobile`\| `PC` \| `Mobile`
`screen`	String	-	Screen resolution
`lang`	String	-	Language code
`visitedPage`	String	-	Played page

`player`

The following describes player.

Field	Type	Required	Description
`playerName`	String	-	Player name
`playerVersion`	String	-	Player version
`playerType`	String	-	Player type
`playerUrl`	String	-	Player domain

`error`

The following describes error.

Field	Type	Required	Description
`errorCode`	Integer	-	Errors
`message`	String	-	Error message

`sessionLog`

The following describes sessionLog.

Field	Type	Required	Description
`logDate`	Date	-	Session creation date and time
`uuid`	String	-	Unique user ID UUID format
`videoTime`	String	-	Play time
`actionType`	String	-	Action type: Event information corresponding to Media Analytics usage `player_start` \| `startup` \| `playing` \| `paused` \| `seeking` \| `rebuffering` \| `prev_tarck` \| `next_track` \| `ended` \| `error` `player_start`: Player started (player ready to play after VPE authentication succeeded) `startup`: Playback successful (user successfully played the first screen of the video after attempting to play it) `playing`: Playback time (reports events every 60 seconds; reports immediately if another event occurs before 60 seconds) `paused`: Stop button clicked `seeking`: Buffering occurred when navigating videos or changing resolution `rebuffering`: Buffering occurred due to insufficient data for the video being played (excluded for `seeking`) `prev_tarck`: Previous video button clicked `next_track`: Next video button clicked `ended`: Video watched to the end (When set to repeat playback, `seeking` occurs at 0 seconds, preventing `ended` from triggering.) `error`: Error occurred
`actionDuration`	Integer	-	Time taken to complete (second)

`media`

The following describes media.

Field	Type	Required	Description
`videoType`	String	-	Playback source type `VOD,LIVE` \| `VOD` \| `LIVE` `VOD,LIVE`: VOD video, LIVE stream `VOD`: VOD video `LIVE`: LIVE stream
`videoFormat`	String	-	Playback source classification
`duration`	Integer	-	Total video length
`url`	String	-	Playback source URL
`title`	String	-	Video title
`logDate`	Date	-	Session creation date and time

Response status codes

For information about the HTTP status codes common to all Video Player Enhancement APIs, see Common Video Player Enhancement response status codes.

Response example

The response example is as follows:

{
	"code": 200,
	"message": "sessionRecentDetail",
	"result": {
		"startTime": {
			"playerStartTimeSum": 0.008,
			"videoStartTimeSum": 0.413,
			"totalStartTimeSum": 0.421
		},
		"user": {
			"os": "Windows / 10",
			"isp": "SK Broadband Co Ltd",
			"nation": "Korea, Republic of",
			"address": "Yeoksam 2-dong, Gangnam-gu, Seoul",
			"browser": "Edge / 141.0.0.0",
			"ip": "***.***.***.***",
			"device": "PC",
			"screen": "1680x1050",
			"lang": "ko",
			"visitedPage": "/demo/scrollFloating"
		},
		"player": {
			"playerName": "vpe-guide-website",
			"playerVersion": "latest",
			"playerType": "VPE",
			"playerUrl": "https://vpe.*********.com"
		},
		"error": [],
		"sessionLog": [
			{
				"logDate": "2025-10-08 12:52:00",
				"logDateUnix": "1759895520830",
				"videoTime": 0,
				"watchingPercent": 0,
				"actionType": "player_start",
				"actionDuration": 0.008,
				"quality": "1080p",
				"errorCode": null,
				"errorMessage": null
			},
			{
				"logDate": "2025-10-08 12:52:01",
				"logDateUnix": "1759895521248",
				"videoTime": 0,
				"watchingPercent": 0,
				"actionType": "startup",
				"actionDuration": 0.413,
				"quality": "1080p",
				"errorCode": null,
				"errorMessage": null
			},
			{
				"logDate": "2025-10-08 12:52:02",
				"logDateUnix": "1759895522082",
				"videoTime": 0,
				"watchingPercent": 0,
				"actionType": "playing",
				"actionDuration": 0.834,
				"quality": "1080p",
				"errorCode": null,
				"errorMessage": null
			}
		],
		"media": [
			{
				"videoType": "VOD",
				"videoFormat": "hls",
				"duration": 91,
				"url": "https://*********.naverncp.com/hls/*********/endpoint/sample/221027_NAVER_Cloud_intro_Long_ver_AVC_,FHD_2Pass_30fps,HD_2Pass_30fps,SD_2Pass_30fps,.mp4.smil/master.m3u8",
				"title": "NAVER Cloud introduction video",
				"logDate": "2025-10-08 12:52:01"
			}
		]
	}
}