Retrieve Series via ID

Endpoint to retrieve information about all talks in a series

All the responses conform to the HAL specification.

GET /series/(string: id)

Retrieve series by unique slug identifier, including all talks

Example request:

GET /api/series/d95be2ef-10bb-43d3-a46c-99dccf7151a0
Host: talks.ox.ac.uk
Accept: application/json

Example response

{
    "_links": {
        "self": {
            "href": "/api/series/d95be2ef-10bb-43d3-a46c-99dccf7151a0"
        },
        "talks_page": {
            "href": "/talks/series/id/d95be2ef-10bb-43d3-a46c-99dccf7151a0"
        }
    },
    "title": "ChemBio Hub Events",
    "description": "",
    "occurence": "",
    "_embedded": {
        "talks": [{
            "_links": {
                "self": {
                    "href": "/api/talks/88ba512b-8ac1-4191-a86e-340f8f3fed1d"
                },
                "talks_page": {
                    "href": "/talks/id/88ba512b-8ac1-4191-a86e-340f8f3fed1d/"
                }
            },
            "title_display": "Current expertise and future directions in drug discovery: an Oxford-Industry conversation",
            "slug": "88ba512b-8ac1-4191-a86e-340f8f3fed1d",
            "start": "2015-07-31T09:00:00Z",
            "end": "2015-07-31T19:00:00Z",
            "formatted_date": "31 July 2015, 9:00",
            "formatted_time": "09:00",
            "description": "This event showcases top chemical biology research from labs at Oxford. ...",
            "location_details": "",
            "location_summary": null,
            "series": {
                "slug": "d95be2ef-10bb-43d3-a46c-99dccf7151a0",
                "title": "ChemBio Hub Events"
            },
            "_embedded": {
                "speakers": [],
                "venue": null,
                "organising_department": {
                    "address": "off South Parks Road OX1 3QU",
                    "_links": {
                        "self": {
                            "href": "//api.m.ox.ac.uk/places/oxpoints:23232534"
                        }
                    },
                    "name": "Department of Biochemistry",
                    "map_link": "//maps.ox.ac.uk/#/places/oxpoints:23232534"
                },
                "topics": []
            },
            "organiser_email": ""
        }]
    }
}

The response can be either in XML or JSON dependent on the ‘accept’ header in the request.

Status Codes:

Parameters Reference

id : series slug as string
  • Format f8ecded3-d2af-4585-bd3b-5cd7440795b9
from : date string (‘yyyy-mm-dd’), optional
  • Start date for the list of talks.
  • Format as yyyy-mm-dd
to : date string (‘yyyy-mm-dd’), optional
  • End date for the list of talks.
  • Format yyyy-mm-dd
  • Or use plus[n] for the next [n] days (e.g.: plus7)
  • Note that the issue with the end time (assumed to be 00:00 not 23:59) has now been resolved