# SchedulePerson

Endpoint to retrieve data for persons, in the currently finalized draft.

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

> Gets \`Person\` objects.

```json
{"openapi":"3.1.1","info":{"title":"Converia API","version":"2.15.0"},"tags":[{"name":"SchedulePerson","description":"Endpoint to retrieve data for persons, in 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":{"Person":{"type":"object","description":"Represents the person entity in Converia.","required":["id","lastName"],"properties":{"id":{"$ref":"#/components/schemas/PersonId"},"firstName":{"type":"string","description":"The first name of the person."},"lastName":{"type":"string","description":"The last name of the person."},"title":{"type":"string","description":"The title of the person."},"email":{"type":"string","description":"The e-mail address of the person."},"company":{"type":"string","description":"Company of the person."},"city":{"type":"string","description":"City of the person."},"country":{"type":"string","description":"Country of the person.","format":"ISO 3166-1 alpha-2 codes"},"photo":{"type":"string","description":"Link to the photo file of the person.","format":"uri"}}},"PersonId":{"type":"integer","description":"The primary key of the person entity in Converia.","minimum":1},"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/person":{"get":{"tags":["SchedulePerson"],"description":"Gets `Person` objects.","summary":"Finds authors by filtering a specific conference(frame).","parameters":[{"schema":{"type":"integer","format":"int64"},"name":"id","in":"path","description":"Id of the conference the persons from the schedule are loaded for.","required":true}],"responses":{"200":{"description":"Successful response","headers":{"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/Person"}}}}}}},"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"}}}}}}}}}
```