Skip to main content

Get a session

Returns the specified session.

URL

GET /v1/sessions/:sessionId

Request URL Parameters

ParameterDescription
:sessionIdID of the session to retrieve.

Response Body

_id
string
Unique identifier for the session.
Example: 65ea1530bb50af72b6e3dc1e
name
string
Name of the session. Maximum 256 characters.
Example: Mobile Word Congress Pitch
type
enum SessionType
Session type
Example: live_analysis
state
enum SessionState
Current state of the session
Example: active
timestamp
date
Timestamp when the session was created.
Example: 2024-04-01T10:30:00.000Z
duration
number
Session duration in seconds.
Example: 120
config
object
Optional
Information about the configuration of the session.
sources
object[]
Optional
Information about the data sources of the session.
meta
object
Optional
Information referred to the internal state of the session.
product
string
Unique ID of the product used to analyze this session (e.g. pro, advanced...).
Example: 65946a77408bd7b32c5189a3
user
string
ID of the user who created the session.
Example: 65d7a8fb532f66218ecd4cab
version
number
Version of the object schema. It should not change often but can be helpful in the future if a new session schema is published.
Example: 3

Response codes

CodeMeaningDescription
200OKThe request has succeeded. The client can read the result in the body.
404Not FoundThe requested resource does not exist or you do not have permissions to perform this action on it.

Request example

curl -X GET 'https://api.emogg.com/v1/sessions/:sessionId' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Example response

{
    "_id": "65ea1530bb50af72b6e3dc1e",
    "name": "Mobile Word Congress Pitch",
    "type": "live_analysis",
    "state": "active",
    "timestamp": "2024-04-01T10:30:00.000Z",
    "duration": 120,
    "config": {
        "removeMedia": true
    },
    "sources": [
        {
            "id": "c1fcba18-15ec-457c-a1de-fcbb87aeaa0e",
            "name": "Integrated Webcam",
            "type": "video",
            "device": "local_camera"
        },
        {...},
        {...}
    ],
    "meta": {
        "expires": "2024-05-01T11:30:00.000Z",
        "healthCheck": "2024-05-01T10:39:30.000Z",
        "workerState": "working"
    },
    "product": "65946a77408bd7b32c5189a3",
    "user": "65d7a8fb532f66218ecd4cab",
    "version": 3
}