GET licence seats by licenceId

Retrieve the seats on a licence.

Request

Resource URL

GET https://api.ft.com/licence/{licenceId}/seats

For security reasons requests must be made over HTTPS.

Parameters

Path param	Mandatory	Value
licenceId	Yes	The unique identifier for the licence which is to be retrieved

Request Headers

Header	Value
X-Api-Key	<API key value>

Request Body

Not supported.

Response

200 - OK

{
    "seats": [
        {
            "userId": "c802a932-22da-422f-841d-4ad9728ff466",
            "joinedDate": "2015-03-16T10:39:22.677Z",
            "accessLicenceId": "c802a932-22da-422f-841d-4ad9728ff466"
        },
        {
            "userId": "c802a932-22da-422f-841d-4ad972855555",
            "joinedDate": "2015-03-18T10:39:22.677Z",
            "accessLicenceId": "c802a932-22da-422f-841d-4ad9728ff466"
        }
    ],
    "allocatedSeatCount": 2
}

400 - Bad Request

{
    "message": "6821f0bf-654e-48de-8b4f-919e4166400e6667777777777 is not a valid AccessLicenceId."
}

HTTP Status Codes

Http Status	Description
200 Ok	A (wrapped) collection of seats is returned
400 Bad request	The request was invalid. You may refer to response for details around why the request was invalid
403 Forbidden	Invalid API key used
404 Not Found	No licence exists for the licenceId provided

Make sure you are using a valid API key. If you are sure your are using a valid API key and problems persist, contact us for assistance.