REST API

TODO

Under development

Available from version x (LS 5.5.0?)

Available API endpoints

Technical specification. UML.

Introduction

LimeSurvey REST API v1 is available in LS 5.5.0 or more recent which offers various API endpoints.

Setup

Configure

In order to use REST API you must first enable the service, and then adjust the settings to suit your needs. To enable login to the LimeSurvey administration, go to Global settings, choose the tab 'Interfaces' and select 'Publish API on /rest'.

Security

The REST API uses the same security measures as the normal administration login. That means that the permission set of the used username and password is the same as if you would login in the administration with that user/password. Also the REST API is protected against brute-force password cracking - like the normal administration login.

Usage

API Location

The REST API URL is http://www.yourdomain.com/rest/v1 .

The available API endpoints are documented using swagger https://api.limesurvey.org/swagger.

Endpoints

Method	Prefix	Endpoint	Notes	HEADER params	URL Path params	POST params	GET params	Command Class	Command Params
	/rest/v1/
POST	*	session	create new session token			(string)username, (string)password, (string)?plugin		SessionKeyCreate	(string)username, (string)password, (string)?plugin
DELETE	*	session		Authorization				SessionKeyRelease	(string)sessionKey
GET	*	siteSettings	list	Authorization				SiteSettingsGet	(string)sessionKey, (string)?settingName
GET	*	siteSettings/<setting-name>	single	Authorization	settingName			SiteSettingsGet	(string)sessionKey, (string)?settingName
POST		survey		Authorization		(int)surveyID, (string)surveyTitle, (string)surveyLanguage, (string)format		SurveyAdd	(string)sessionKey, (int)?surveyID, (string)surveyTitle, (string)surveyLanguage, (string)format