# ScheduleSession

Endpoint to retrieve data for sessions, of the currently finalized draft

## Finds sessions by filtering a specific conference(frame).

> Gets \`ScheduleSession\` objects.

```json
{"openapi":"3.1.1","info":{"title":"Converia API","version":"2.15.0"},"tags":[{"name":"ScheduleSession","description":"Endpoint to retrieve data for sessions, of the currently finalized draft"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"description":"Api key has to be used to authenticate against the server. The token parameter has must be sent in the header","type":"apiKey","name":"token","in":"header"}},"schemas":{"ScheduleSession":{"type":"object","description":"Represents the schedule session entity in Converia.","required":["id","title","formOfPresentation","day","timeIndependent","start","end","room","publicized","additionalInformation"],"properties":{"id":{"$ref":"#/components/schemas/SessionId"},"title":{"type":"array","description":"The session title.","items":{"$ref":"#/components/schemas/Translation"}},"description":{"type":"array","description":"The description of the session.","items":{"$ref":"#/components/schemas/Translation"}},"topic":{"$ref":"#/components/schemas/TopicId"},"formOfPresentation":{"$ref":"#/components/schemas/FormOfPresentationId"},"day":{"$ref":"#/components/schemas/DayId"},"timeIndependent":{"type":"boolean","description":"Indicates if corresponding events are time-independent. This concerns only events of type PaperEvent."},"start":{"type":"string","description":"Time when the session starts.","format":"ISO-8601"},"end":{"type":"string","description":"Time when the session ends.","format":"ISO-8601"},"room":{"$ref":"#/components/schemas/RoomId"},"chairs":{"type":"array","description":"Contains all chairs of the session.","items":{"$ref":"#/components/schemas/Chair"}},"events":{"type":"array","description":"The events of the session.","items":{"$ref":"#/components/schemas/EventId"}},"publicized":{"type":"boolean","description":"True if publication of the session is allowed, false otherwise."},"sponsor":{"$ref":"#/components/schemas/Sponsor"},"additionalInformation":{"type":"object","description":"Additional information about the session.","required":["videoRecordingAllowed","ted"],"properties":{"videoRecordingAllowed":{"type":"boolean","description":"Indicates if it is allowed to record the session."},"ted":{"type":"boolean","description":"True if the session is a TED (Technology, Entertainment, Design) session, false otherwise."}}},"continuingMedicalEducation":{"$ref":"#/components/schemas/ContinuingMedicalEducation"},"keywords":{"type":"array","description":"Keywords assigned to the session.","items":{"type":"string"}}}},"SessionId":{"type":"integer","description":"The primary key of the session entity in Converia.","minimum":1},"Translation":{"type":"object","description":"","required":["language","content"],"properties":{"language":{"type":"string","description":"","format":"Combination of ISO 639-1 alpha-2 and ISO 3166-1 alpha-2 codes, see RFC 5646.","minLength":5,"maxLength":5},"content":{"type":"string","description":"The translated content."}}},"TopicId":{"type":"integer","description":"The primary key of the topic entity in Converia."},"FormOfPresentationId":{"type":"integer","description":"The primary key of the form of presentation entity in Converia."},"DayId":{"type":"integer","description":"The primary key of the day entity in Converia.","minimum":1},"RoomId":{"type":"integer","description":"The primary key of the room entity in Converia.","minimum":1},"Chair":{"type":"object","description":"Represents a session chair in Converia.","required":["person"],"properties":{"person":{"$ref":"#/components/schemas/PersonId"},"role":{"$ref":"#/components/schemas/RoleId"}}},"PersonId":{"type":"integer","description":"The primary key of the person entity in Converia.","minimum":1},"RoleId":{"type":"integer","description":"The primary key of the role entity in Converia.","minimum":1},"EventId":{"type":"integer","description":"The primary key of the event entity in Converia.","minimum":1},"Sponsor":{"type":"object","description":"Represents a session sponsor in Converia.","required":["name"],"properties":{"name":{"type":"string","description":"The name of the sponsor."},"text":{"type":"string","description":"An arbitrary description related to the sponsor."},"logo":{"type":"string","description":"Link to the sponsor logo.","format":"uri"}}},"ContinuingMedicalEducation":{"type":"object","description":"Represents the Continuing medical education (CME) object in Converia.","properties":{"credits":{"type":"integer","description":"Credits the participant can earn."},"category":{"type":"string","description":"The CME category."}}},"ErrorResult":{"type":"object","description":"Result format in an error case.","required":["errors"],"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}}}},"Error":{"type":"object","description":"Format of an error.","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/rest-api/v2/frame/{id}/schedule/session":{"get":{"tags":["ScheduleSession"],"description":"Gets `ScheduleSession` objects.","summary":"Finds sessions by filtering a specific conference(frame).","parameters":[{"schema":{"type":"integer","format":"int64"},"name":"id","in":"path","description":"Id of the conference the sessions are loaded for.","required":true}],"responses":{"200":{"description":"Successful response","headers":{"Content-Language":{"schema":{"type":"string"},"description":"Comma separated language tags. Contains information about which language tags are provided by the API. Each language tag is a combination of ISO 639-1 alpha-2 and ISO 3166-1 alpha-2 codes."},"X-Rate-Limit-Interval":{"schema":{"type":"integer"},"description":"Interval of a time window in seconds"},"X-Rate-Limit-Reset":{"schema":{"type":"integer"},"description":"The remaining window before the credit limit resets in seconds"},"X-Rate-Limit-Remaining":{"schema":{"type":"integer"},"description":"The number of credits left for the time window"},"X-Rate-Limit-Limit":{"schema":{"type":"integer"},"description":"Credit limit per time window"}},"content":{"application/json":{"schema":{"title":"Result Record","type":"object","required":["meta","data"],"properties":{"meta":{"type":"object","required":["lastFinalization"],"properties":{"lastFinalization":{"type":"string","description":"","format":"ISO-8601"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/ScheduleSession"}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResult"}}}},"401":{"description":"Authentication problem","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResult"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResult"}}}},"404":{"description":"No resource found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResult"}}}},"429":{"description":"Rate limitation exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResult"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResult"}}}}}}}}}
```