Paths

Return all used API URLs

GET /

Responses

HTTP Code Description Schema

200

OK

< Link > array

Produces

  • application/json

  • text/json

  • application/xml

  • text/xml

Tags

  • Root

Add telephone number to the blacklist

POST /blacklist

Parameters

Type Name Description Schema

Body

TelephoneBlacklistItem
required

The entity to post

Responses

HTTP Code Description Schema

200

OK

integer (int32)

201

Created

integer (int32)

400

BadRequest

No Content

Consumes

  • application/json

Produces

  • application/json

Tags

  • BlackList

Get telephone numbers from the blacklist using OData filter

GET /blacklist

Parameters

Type Name Description Schema

Query

$filter
optional

Filters the results, based on a Boolean condition.

string

Query

$orderby
optional

Sorts the results.

string

Query

$skip
optional

Skips the first n results.

integer (int32)

Query

$top
optional

Returns only the first n results.

integer (int32)

Responses

HTTP Code Description Schema

200

OK

400

BadRequest

No Content

Produces

  • application/json

Tags

  • BlackList

Get telephone number from the blacklist by the unique identifier

GET /blacklist({Id})

Parameters

Type Name Description Schema

Path

Id
required

key: Id

integer (int32)

Responses

HTTP Code Description Schema

200

OK

400

BadRequest

No Content

Produces

  • application/json

Tags

  • BlackList

Update telephone number in the blacklist

PUT /blacklist({Id})

Parameters

Type Name Description Schema

Path

Id
required

key: Id

integer (int32)

Body

TelephoneBlacklistItem
required

The entity to put

Responses

HTTP Code Description Schema

200

OK

400

BadRequest

No Content

Consumes

  • application/json

Produces

  • application/json

Tags

  • BlackList

Delete telephone number from the blacklist

DELETE /blacklist({Id})

Parameters

Type Name Description Schema

Header

If-Match
optional

If-Match header

string

Path

Id
required

key: Id

integer (int32)

Responses

HTTP Code Description Schema

204

NoContent

400

BadRequest

No Content

404

NotFound

No Content

Tags

  • BlackList

Add a list of the telephone numbers to the blacklist. The number of added elements cannot be more than 10000.

POST /blacklist/Controller.Import

Parameters

Type Name Description Schema

Body

parameters
optional

OData parameters which contains list of the telephone numbers to be added to the blacklist

parameters

Name Schema

BlackListItems
optional

Responses

HTTP Code Description Schema

201

Created

204

No Content

No Content

400

BadRequest

No Content

Consumes

  • application/json

Tags

  • BlackList

Get history of breaks using OData filter

GET /breakhistory

Parameters

Type Name Description Schema

Query

$filter
optional

Filters the results, based on a Boolean condition.

string

Query

$orderby
optional

Sorts the results.

string

Query

$skip
optional

Skips the first n results.

integer (int32)

Query

$top
optional

Returns only the first n results.

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< BreakHistory > array

Produces

  • application/json

Tags

  • BreakHistory

Get a specific break history entity by id

GET /breakhistory({Id})

Parameters

Type Name Description Schema

Path

Id
required

key: Id

integer (int32)

Responses

HTTP Code Description Schema

200

OK

Produces

  • application/json

Tags

  • BreakHistory

Get history of calls using OData filter

GET /callhistory

Parameters

Type Name Description Schema

Query

$filter
optional

Filters the results, based on a Boolean condition.

string

Query

$orderby
optional

Sorts the results.

string

Query

$skip
optional

Skips the first n results.

integer (int32)

Query

$top
optional

Returns only the first n results.

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< CallHistory > array

Produces

  • application/json

Tags

  • CallHistory

Get a specific call history entity by id

GET /callhistory({Id})

Parameters

Type Name Description Schema

Path

Id
required

key: Id

integer (int32)

Responses

HTTP Code Description Schema

200

OK

Produces

  • application/json

Tags

  • CallHistory

Get call history including replicated variables

GET /callhistorywithvariables

Parameters

Type Name Description Schema

Query

endTime
optional

When specified, only events that occurred before this time will be returned

string (date-time)

Query

includeBreakTimes
optional

Whether break times are to be included

boolean

Query

includeLoginLogoutInfo
optional

Whether login/logout information is to be included in the result

boolean

Query

startTime
optional

When specified, only events occurring after this time will be returned

string (date-time)

Query

surveyIds
optional

List of unique identifiers for the surveys (pXXXXXXXX), separated by comma or semicolon. If not specified, the history for all surveys will be returned.

string

Query

variables
optional

Survey field names separated by comma or semicolon (having 'Available as CATI filter' option enabled) to be included in the result

string

Responses

HTTP Code Description Schema

200

OK

Produces

  • application/json

Tags

  • CallHistoryWithVariables

Create a new interviewer group

POST /groups

Parameters

Type Name Description Schema

Body

group
required

The instance of the group object

Responses

HTTP Code Description Schema

200

OK

integer (int32)

Consumes

  • application/json

Produces

  • application/json

Tags

  • Groups

Get groups using OData filter

GET /groups

Parameters

Type Name Description Schema

Query

$filter
optional

Filters the results, based on a Boolean condition.

string

Query

$orderby
optional

Sorts the results.

string

Query

$skip
optional

Skips the first n results.

integer (int32)

Query

$top
optional

Returns only the first n results.

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< Group > array

Produces

  • application/json

Tags

  • Groups

Get a specific group by an identifier

GET /groups({GroupId})

Parameters

Type Name Description Schema

Path

GroupId
required

key: GroupId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

Produces

  • application/json

Tags

  • Groups

Update an existing interviewer group

PUT /groups({GroupId})

Parameters

Type Name Description Schema

Path

GroupId
required

key: GroupId

integer (int32)

Body

group
required

The instance of the group object

Responses

HTTP Code Description Schema

200

OK

integer (int32)

Consumes

  • application/json

Produces

  • application/json

Tags

  • Groups

Delete an existing interviewer group

DELETE /groups({GroupId})

Parameters

Type Name Description Schema

Header

If-Match
optional

If-Match header

string

Path

GroupId
required

key: GroupId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Groups

Assign the specified group to the specified call

GET /groups({GroupId})/Controller.AssignOnCall(surveyId='{surveyId}',interviewId={interviewId},callCenterId={callCenterId})

Parameters

Type Name Description Schema

Path

GroupId
required

key: GroupId

integer (int32)

Path

callCenterId
required

Unique identifier of the call center

integer (int32)

Path

interviewId
required

Unique identifier of the interview

integer (int32)

Path

surveyId
required

Unique identifier of the survey (pXXXXXXXX)

string

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Groups

Assign the specified group to the specified survey

GET /groups({GroupId})/Controller.AssignOnSurvey(surveyId='{surveyId}',callCenterId={callCenterId})

Parameters

Type Name Description Schema

Path

GroupId
required

key: GroupId

integer (int32)

Path

callCenterId
required

Unique identifier of the call center

integer (int32)

Path

surveyId
required

Unique identifier of the survey (pXXXXXXXX)

string

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Groups

Unassign the specified group from all calls on the specified survey

GET /groups({GroupId})/Controller.DeAssignFromCalls(surveyId='{surveyId}',callCenterId={callCenterId})

Parameters

Type Name Description Schema

Path

GroupId
required

key: GroupId

integer (int32)

Path

callCenterId
required

Unique identifier of the call center

integer (int32)

Path

surveyId
required

Unique identifier of the survey (pXXXXXXXX)

string

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Groups

Unassign the specified group from the specified survey

GET /groups({GroupId})/Controller.DeAssignFromSurvey(surveyId='{surveyId}',callCenterId={callCenterId})

Parameters

Type Name Description Schema

Path

GroupId
required

key: GroupId

integer (int32)

Path

callCenterId
required

Unique identifier of the call center

integer (int32)

Path

surveyId
required

Unique identifier of the survey (pXXXXXXXX)

string

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Groups

Get all assignment information related to the specified group

GET /groups({GroupId})/Controller.GetAssignments(callCenterId={callCenterId})

Parameters

Type Name Description Schema

Path

GroupId
required

key: GroupId

integer (int32)

Path

callCenterId
required

Unique identifier of the call center

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< SurveyAssignment > array

Produces

  • application/json

Tags

  • Groups

Get all interviewers belonging to the specified group

GET /groups({GroupId})/Controller.GetInterviewers(callCenterId={callCenterId})

Parameters

Type Name Description Schema

Path

GroupId
required

key: GroupId

integer (int32)

Path

callCenterId
required

Unique identifier of the call center

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< Interviewer > array

Produces

  • application/json

Tags

  • Groups

Check that CATI REST API is alive

GET /healthz/live

Responses

HTTP Code Description Schema

200

OK

boolean

Produces

  • application/json

  • text/json

  • application/xml

  • text/xml

Tags

  • Healthz

Check that CATI REST API is ready to work

GET /healthz/ready

Responses

HTTP Code Description Schema

200

OK

boolean

Produces

  • application/json

  • text/json

  • application/xml

  • text/xml

Tags

  • Healthz

Create a new interviewer

POST /interviewerproperties

Parameters

Type Name Description Schema

Body

interviewerProperties
required

The instance of the InterviewerProperties object

Responses

HTTP Code Description Schema

200

OK

integer (int32)

Consumes

  • application/json

Produces

  • application/json

Tags

  • InterviewerProperties

Update an existing interviewer

PUT /interviewerproperties({InterviewerId})

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Body

interviewerProperties
required

The instance of the InterviewerProperties object

Responses

HTTP Code Description Schema

200

OK

integer (int32)

Consumes

  • application/json

Produces

  • application/json

Tags

  • InterviewerProperties

Delete an existing interviewer

DELETE /interviewerproperties({InterviewerId})

Parameters

Type Name Description Schema

Header

If-Match
optional

If-Match header

string

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • InterviewerProperties

Get interviewers list using OData filter

GET /interviewers

Parameters

Type Name Description Schema

Query

$filter
optional

Filters the results, based on a Boolean condition.

string

Query

$orderby
optional

Sorts the results.

string

Query

$skip
optional

Skips the first n results.

integer (int32)

Query

$top
optional

Returns only the first n results.

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< Interviewer > array

Produces

  • application/json

Tags

  • Interviewers

Get a specific interviewer by id

GET /interviewers({InterviewerId})

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

Produces

  • application/json

Tags

  • Interviewers

Assign the specified interviewer to the specified call

GET /interviewers({InterviewerId})/Controller.AssignOnCall(surveyId='{surveyId}',interviewId={interviewId})

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Path

interviewId
required

Unique identifier of the interview

integer (int32)

Path

surveyId
required

Unique identifier of the survey (pXXXXXXXX)

string

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Interviewers

Assign the specified interviewer to the specified survey

GET /interviewers({InterviewerId})/Controller.AssignOnSurvey(surveyId='{surveyId}')

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Path

surveyId
required

Unique identifier of the survey (pXXXXXXXX)

string

Responses

HTTP Code Description Schema

200

OK

boolean

Produces

  • application/json

Tags

  • Interviewers

Remove all assignments from the specified interviewer

GET /interviewers({InterviewerId})/Controller.CleanAssignments()

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Interviewers

Unassign the specified interviewer from all calls on the specified survey

GET /interviewers({InterviewerId})/Controller.DeAssignFromCalls(surveyId='{surveyId}')

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Path

surveyId
required

Unique identifier of the survey (pXXXXXXXX)

string

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Interviewers

Unassign the specified interviewer from the specified survey

GET /interviewers({InterviewerId})/Controller.DeAssignFromSurvey(surveyId='{surveyId}')

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Path

surveyId
required

Unique identifier of the survey (pXXXXXXXX)

string

Responses

HTTP Code Description Schema

200

OK

boolean

Produces

  • application/json

Tags

  • Interviewers

Get all assignment information related to the specified interviewer

GET /interviewers({InterviewerId})/Controller.GetAssignments()

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< SurveyAssignment > array

Produces

  • application/json

Tags

  • Interviewers

Get list of groups which contains the specified interviewer

GET /interviewers({InterviewerId})/Controller.GetGroups()

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< Group > array

Produces

  • application/json

Tags

  • Interviewers

Lock interviewer

GET /interviewers({InterviewerId})/Controller.Lock()

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Interviewers

Lock interviewer

GET /interviewers({InterviewerId})/Controller.Unlock()

Parameters

Type Name Description Schema

Path

InterviewerId
required

key: InterviewerId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

204

No Content

No Content

Tags

  • Interviewers

Get history of interviewer sessions using OData filter

GET /interviewersessionhistory

Parameters

Type Name Description Schema

Query

$filter
optional

Filters the results, based on a Boolean condition.

string

Query

$orderby
optional

Sorts the results.

string

Query

$skip
optional

Skips the first n results.

integer (int32)

Query

$top
optional

Returns only the first n results.

integer (int32)

Responses

HTTP Code Description Schema

200

OK

Produces

  • application/json

Tags

  • InterviewerSessionHistory

Get history of interviewer sessions using OData filter

GET /interviewersessionhistory({SessionId})

Parameters

Type Name Description Schema

Path

SessionId
required

key: SessionId

integer (int32)

Responses

HTTP Code Description Schema

200

OK

Produces

  • application/json

Tags

  • InterviewerSessionHistory

Get surveys using OData filter

GET /surveys

Parameters

Type Name Description Schema

Query

$filter
optional

Filters the results, based on a Boolean condition.

string

Query

$orderby
optional

Sorts the results.

string

Query

$skip
optional

Skips the first n results.

integer (int32)

Query

$top
optional

Returns only the first n results.

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< Survey > array

Produces

  • application/json

Tags

  • Surveys

Get survey by survey ID

GET /surveys('{SurveyId}')

Parameters

Type Name Description Schema

Path

SurveyId
required

key: SurveyId

string

Responses

HTTP Code Description Schema

200

OK

Produces

  • application/json

Tags

  • Surveys

Close the survey

GET /surveys('{SurveyId}')/Controller.Close()

Parameters

Type Name Description Schema

Path

SurveyId
required

key: SurveyId

string

Responses

HTTP Code Description Schema

200

OK

boolean

Produces

  • application/json

Tags

  • Surveys

Get all assignment information related to the specified survey

GET /surveys('{SurveyId}')/Controller.GetAssignments(callCenterId={callCenterId})

Parameters

Type Name Description Schema

Path

SurveyId
required

key: SurveyId

string

Path

callCenterId
required

integer (int32)

Responses

HTTP Code Description Schema

200

OK

< ResourceAssignment > array

Produces

  • application/json

Tags

  • Surveys

Get basic properties of the survey

GET /surveys('{SurveyId}')/Controller.GetBasicProperties()

Parameters

Type Name Description Schema

Path

SurveyId
required

key: SurveyId

string

Responses

HTTP Code Description Schema

200

OK

Produces

  • application/json

Tags

  • Surveys

Open the survey

GET /surveys('{SurveyId}')/Controller.Open()

Parameters

Type Name Description Schema

Path

SurveyId
required

key: SurveyId

string

Responses

HTTP Code Description Schema

200

OK

boolean

Produces

  • application/json

Tags

  • Surveys

Update basic properties of the survey

GET /surveys('{SurveyId}')/Controller.PutBasicProperties(properties='{properties}')

Parameters

Type Name Description Schema

Path

SurveyId
required

key: SurveyId

string

Path

properties
required

Json serialized string of SurveyBasicProperties object

string

Responses

HTTP Code Description Schema

200

OK

boolean

Produces

  • application/json

Tags

  • Surveys

Shutdown the survey

GET /surveys('{SurveyId}')/Controller.Shutdown()

Parameters

Type Name Description Schema

Path

SurveyId
required

key: SurveyId

string

Responses

HTTP Code Description Schema

200

OK

boolean

Produces

  • application/json

Tags

  • Surveys