Voxco Responses API
The Responses API from Voxco — 4 operation(s) for responses.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/voxco-responses-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Ascribe Coder AICoder Responses API
description: <br/> To import this API to Postman, copy the URL from the top of this page.<br/> Open Postman, and select Import.<br/> In the dialog select 'Import From Link'.<br/> Paste the URL and click Import.<br/><br/> To use this API interactively from this page, open the POST Sessions operation below.<br/> Click the Example Value in the Parameters section to move it to the request.<br/> Modify the request with your credentials, then click "Try it out!"<br/> Copy the value of the bearerToken returned in the response to the api_key text box at the top of this page.<br/> You can now interact with the other resources on this page.<br/> You can save the bearer token for future use without needing to POST to the Sessions resource again.
contact:
email: support@goascribe.com
version: v2
servers:
- url: https://api.goascribe.us/coder/v2
description: US Servers
- url: https://api.goascribe.eu/coder/v2
description: EU Servers
- url: https://api-ca.goascribe.com/coder/v2
description: CA Servers
security:
- Bearer: []
tags:
- name: Responses
paths:
/Responses/{QuestionKey}/{RespondentID}:
delete:
tags:
- Responses
summary: Delete a response from the database by using pair of question key and respondent id
description: Method deletes the response by using question key and respondent id.
parameters:
- name: QuestionKey
in: path
description: Key of question
required: true
schema:
type: integer
format: int32
- name: RespondentID
in: path
description: ID of respondent
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteResponseResponse'
example:
errorMessage: null
/Responses/Batch:
delete:
tags:
- Responses
summary: Delete a batch of responses from the database by using pairs of question key and respondent id
description: Method deletes a batch of responses by using pairs of question key and respondent id.
requestBody:
description: Array of pairs of question key and respondent id.
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteResponsesBatchRequest'
example:
questionResponses:
- questionKey: 55
respondentIDs:
- '100001'
- '100002'
- questionKey: 56
respondentIDs:
- '200001'
- questionKey: 57
respondentIDs:
- '300001'
- '300002'
- '300003'
text/json:
schema:
$ref: '#/components/schemas/DeleteResponsesBatchRequest'
example:
questionResponses:
- questionKey: 55
respondentIDs:
- '100001'
- '100002'
- questionKey: 56
respondentIDs:
- '200001'
- questionKey: 57
respondentIDs:
- '300001'
- '300002'
- '300003'
application/*+json:
schema:
$ref: '#/components/schemas/DeleteResponsesBatchRequest'
example:
questionResponses:
- questionKey: 55
respondentIDs:
- '100001'
- '100002'
- questionKey: 56
respondentIDs:
- '200001'
- questionKey: 57
respondentIDs:
- '300001'
- '300002'
- '300003'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteResponsesBatchResponse'
example:
questionResponses:
- questionKey: 55
respondentID: '100001'
errorMessage: null
- questionKey: 55
respondentID: '100002'
errorMessage: null
- questionKey: 56
respondentID: '200001'
errorMessage: null
- questionKey: 57
respondentID: '300001'
errorMessage: 'SQL Exception: Cannot delete. Trigger TR_Responses_BeforeDeleteCheck.'
- questionKey: 57
respondentID: '300002'
errorMessage: null
- questionKey: 57
respondentID: '300003'
errorMessage: null
errorMessage: null
/Responses/{questionKey}:
get:
tags:
- Responses
summary: Get the Responses in the specified Question
description: 'For coded responses the keys of the applied codes are returned for each response.
These keys can be matched to the keys of the codes returned in a query for the codebook to find the details of each of the applied codes.
The optional date query parameters are UTC date/time values.
These should be specified in the form:
YYYY-MM-DDThh:mm:ss
Where the hour ranges from 0 to 23. For example:
2020-02-23T16:05:17
If the time portion of the date/time value is omitted it is assumed to be 00:00:00 GMT.'
parameters:
- name: questionKey
in: path
description: The key of the Question, which must be an integer value.
required: true
schema:
type: integer
format: int32
- name: includeText
in: query
description: "If true, the text of each Response is returned.\n\n If false or omitted the text is not returned."
schema:
type: boolean
default: false
- name: status
in: query
description: 'If omitted, all Responses for the Question are returned.
If present, one of these values:
<ul><li>coded: return only Responses with at least one Code applied.
</li><li>uncoded: return only Responses with no Code applied.</li></ul>'
schema:
type: string
- name: codedAfter
in: query
description: If present, only responses with a code applied on or after the specified date/time are returned.
schema:
type: string
format: date-time
- name: codedBefore
in: query
description: If present, only responses with a code applied before the specified date/time are returned.
schema:
type: string
format: date-time
- name: loadedAfter
in: query
description: If present, only responses loaded on or after the specified date/time are returned.
schema:
type: string
format: date-time
- name: loadedBefore
in: query
description: If present, only responses loaded before the specified date/time are returned.
schema:
type: string
format: date-time
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GetResponsesResponse'
example:
responses:
- rid: 34-22907
text: I do not like the red color
transcription: null
translation: null
notes: null
codeKeys:
- 4978
- 886
- rid: 34-22988
text: This is a fantastic product
transcription: null
translation: null
notes: null
codeKeys:
- 449
errorMessage: null
post:
tags:
- Responses
summary: Add Responses to a Question
description: "This operation will add new responses to the specified question, optionally autocoding them. It will never modify existing responses.\n\nFor each QuestionResponse submitted, if the question does not have a response stored in Ascribe with the specified respondent id,\n\nthen the response will be added.\n \nOtherwise, the Response stored in Ascribe will not be modified. The QuestionResponse submitted will be ignored,\n\nand any codes that have been applied to the Response will be unchanged.\n\n\nThis operation allows the use of a Rule Set to modify or veto the Responses submitted, and automatically coding the responses as they are added.\n"
parameters:
- name: questionKey
in: path
description: The key of the question, which must be an integer value
required: true
schema:
type: integer
format: int32
requestBody:
description: The responses to add
content:
application/json:
schema:
$ref: '#/components/schemas/PostResponsesRequest'
example:
responses:
- appliedcodes: null
segmentcodes: null
rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- appliedcodes: null
segmentcodes: null
rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
autoCodeTextMatch: false
autoCodeInputId: false
autoCodeByRegex: false
text/json:
schema:
$ref: '#/components/schemas/PostResponsesRequest'
example:
responses:
- appliedcodes: null
segmentcodes: null
rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- appliedcodes: null
segmentcodes: null
rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
autoCodeTextMatch: false
autoCodeInputId: false
autoCodeByRegex: false
application/*+json:
schema:
$ref: '#/components/schemas/PostResponsesRequest'
example:
responses:
- appliedcodes: null
segmentcodes: null
rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- appliedcodes: null
segmentcodes: null
rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
autoCodeTextMatch: false
autoCodeInputId: false
autoCodeByRegex: false
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PostResponsesResponse'
example:
codebookKey: 86443
responsesAdded: 2
existingResponsesUnchanged: 0
responsesCoded: 0
responsesCodedByTextMatch: 0
responsesCodedByInputId: 0
responsesCodedByRegex: 0
addedResponses:
- codes:
- codeKey: 200404044
description: Red
rid: 34-22907
verbatim: null
translation: null
transcription: null
notes: null
- codes: []
rid: 34-22988
verbatim: null
translation: null
transcription: null
notes: null
errorMessage: null
put:
tags:
- Responses
summary: Add or update Responses in the specified Question
description: "If the Question does not have a Response stored in Ascribe with the specified respondent id, then the response will be added.\n \nOtherwise, the Response stored in Ascribe will be updated if any of the properties of in the request differ from the values of the current properties of the Response."
parameters:
- name: questionKey
in: path
description: The key of the Question, which must be an integer value.
required: true
schema:
type: integer
format: int32
requestBody:
description: The Responses to add or update.
content:
application/json:
schema:
$ref: '#/components/schemas/PutResponsesRequest'
example:
responses:
- appliedcodes: null
segmentcodes: null
rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- appliedcodes: null
segmentcodes: null
rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
codingMethod: 0
allowEmptyStrings: false
text/json:
schema:
$ref: '#/components/schemas/PutResponsesRequest'
example:
responses:
- appliedcodes: null
segmentcodes: null
rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- appliedcodes: null
segmentcodes: null
rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
codingMethod: 0
allowEmptyStrings: false
application/*+json:
schema:
$ref: '#/components/schemas/PutResponsesRequest'
example:
responses:
- appliedcodes: null
segmentcodes: null
rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- appliedcodes: null
segmentcodes: null
rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
codingMethod: 0
allowEmptyStrings: false
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PutResponsesResponse'
example:
responsesAdded: 10
existingResponsesUpdated: 15
existingResponsesUnchanged: 5
responsesCoded: 0
errorMessage: null
/Responses/{studyKey}/Batch:
post:
tags:
- Responses
summary: Add Responses to the specified Study's Questions
description: "This operation will add new responses to the specified study's questions.\n \nFor each of question it will work absolutely the same way as POST /Responses/{questionKey} method does."
parameters:
- name: studyKey
in: path
description: The key of the study, which must be an integer value
required: true
schema:
type: integer
format: int32
requestBody:
description: The responses to add
content:
application/json:
schema:
$ref: '#/components/schemas/PostResponsesBatchRequest'
example:
questionResponses:
- questionKey: 212345
responses:
- rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
- questionKey: 212346
responses:
- rid: 34-22907
verbatim: France
translation: null
transcription: null
notes: null
- rid: 34-22988
verbatim: USA
translation: null
transcription: null
notes: null
text/json:
schema:
$ref: '#/components/schemas/PostResponsesBatchRequest'
example:
questionResponses:
- questionKey: 212345
responses:
- rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
- questionKey: 212346
responses:
- rid: 34-22907
verbatim: France
translation: null
transcription: null
notes: null
- rid: 34-22988
verbatim: USA
translation: null
transcription: null
notes: null
application/*+json:
schema:
$ref: '#/components/schemas/PostResponsesBatchRequest'
example:
questionResponses:
- questionKey: 212345
responses:
- rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
- questionKey: 212346
responses:
- rid: 34-22907
verbatim: France
translation: null
transcription: null
notes: null
- rid: 34-22988
verbatim: USA
translation: null
transcription: null
notes: null
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PostResponsesBatchResponse'
example:
questionResponses:
- questionKey: 1001
questionId: Q1
addedResponses:
- rid: 34-22907
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- rid: 34-22988
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
- questionKey: 1002
questionId: Q2
addedResponses:
- rid: 34-22907
verbatim: France
translation: null
transcription: null
notes: null
- rid: 34-22988
verbatim: USA
translation: null
transcription: null
notes: null
errorMessage: null
put:
tags:
- Responses
summary: Add or update Responses to the specified Study's Questions
parameters:
- name: studyKey
in: path
description: Key of study
required: true
schema:
type: integer
format: int32
requestBody:
description: The study questions and their responses to update/add
content:
application/json:
schema:
$ref: '#/components/schemas/PutResponsesBatchRequest'
example:
questionResponses:
- questionKey: 200011
responses:
- rid: ABC_12345
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- rid: ABC_12346
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
- questionKey: 200012
responses:
- rid: ABC_12345
verbatim: Very good
translation: null
transcription: null
notes: null
- rid: ABC_12346
verbatim: I can't answer this question
translation: null
transcription: null
notes: null
- rid: ABC_12347
verbatim: If it has green color, it would be better
translation: null
transcription: null
notes: null
allowEmptyStrings: false
text/json:
schema:
$ref: '#/components/schemas/PutResponsesBatchRequest'
example:
questionResponses:
- questionKey: 200011
responses:
- rid: ABC_12345
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- rid: ABC_12346
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
- questionKey: 200012
responses:
- rid: ABC_12345
verbatim: Very good
translation: null
transcription: null
notes: null
- rid: ABC_12346
verbatim: I can't answer this question
translation: null
transcription: null
notes: null
- rid: ABC_12347
verbatim: If it has green color, it would be better
translation: null
transcription: null
notes: null
allowEmptyStrings: false
application/*+json:
schema:
$ref: '#/components/schemas/PutResponsesBatchRequest'
example:
questionResponses:
- questionKey: 200011
responses:
- rid: ABC_12345
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- rid: ABC_12346
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
- questionKey: 200012
responses:
- rid: ABC_12345
verbatim: Very good
translation: null
transcription: null
notes: null
- rid: ABC_12346
verbatim: I can't answer this question
translation: null
transcription: null
notes: null
- rid: ABC_12347
verbatim: If it has green color, it would be better
translation: null
transcription: null
notes: null
allowEmptyStrings: false
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PutResponsesBatchResponse'
example:
questionResponses:
- questionKey: 1
questionId: Q1
updatedResponses:
- rid: ABC_12345
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- rid: ABC_12346
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
addedResponses: []
unchangedResponses: []
errorMessage: null
- questionKey: 2
questionId: Q2
updatedResponses:
- rid: ABC_12345
verbatim: I do not like the red color
translation: null
transcription: null
notes: null
- rid: ABC_12346
verbatim: This is a fantastic product
translation: null
transcription: null
notes: null
addedResponses:
- rid: ABC_12347
verbatim: If it has green color, it would be better
translation: null
transcription: null
notes: null
unchangedResponses: []
errorMessage: null
errorMessage: null
components:
schemas:
DeleteQuestionResponses:
type: object
properties:
questionKey:
type: integer
description: Key of question
format: int32
respondentIDs:
type:
- array
- 'null'
items:
type: string
description: Array of respondent ids to delete from the question
additionalProperties: false
description: Question respondents to delete.
DeleteResponsesBatchResponse:
type: object
properties:
errorMessage:
type:
- string
- 'null'
questionResponses:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/DeleteQuestionResponseResultItem'
description: List of result items of deletion of responses
additionalProperties: false
description: Response contains information about which responses were deleted and which ones were not.
DeleteResponsesBatchRequest:
type: object
properties:
questionResponses:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/DeleteQuestionResponses'
description: Array of pairs of question key and respondent id
additionalProperties: false
description: Request contains array of pairs of question key and respondent id
PutResponse:
required:
- rid
type: object
properties:
rid:
minLength: 1
type: string
description: 'The respondent id, which is unique among Responses in this Question.
This id identifies the respondent in the Study, and that respondent''s Response in this Question.'
verbatim:
type:
- string
- 'null'
description: 'The verbatim text of the response, in other words the answer the respondent gave to the question posed.
Required if this is a new respondent, optional if updating an existing response for this respondent.'
translation:
type:
- string
- 'null'
description: Optional translation of the verbatim text.
transcription:
type:
- string
- 'null'
description: Optional transcription of the response.
notes:
type:
- string
- 'null'
description: Optional notes associated with the response.
appliedcodes:
type:
- array
- 'null'
items:
type: integer
format: int32
description: Array of codes to apply to the response. Note this will ignore any listed codes already applied and will not remove any.
segmentcodes:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/SegmentCode'
description: Array of segments of applied codes
additionalProperties: false
description: A respondent's answer to the question.
PostResponse:
required:
- rid
type: object
properties:
rid:
minLength: 1
type: string
description: 'The respondent id, which is unique among Responses in this Question.
This id identifies the respondent in the Study, and that respondent''s Response in this Question.'
verbatim:
type:
- string
- 'null'
description: 'The verbatim text of the response, in other words the answer the respondent gave to the question posed.
Required if this is a new respondent, optional if updating an existing response for this respondent.'
translation:
type:
- string
- 'null'
description: Optional translation of the verbatim text.
transcription:
type:
- string
- 'null'
description: Optional transcription of the response.
notes:
type:
- string
- 'null'
description: Optional notes associated with the response.
appliedcodes:
type:
- array
- 'null'
items:
type: integer
format: int32
description: Array of codes to apply to the response. Note this will ignore any listed codes already applied and will not remove any.
segmentcodes:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/SegmentCode'
description: Array of segments of applied codes
additionalProperties: false
description: A respondent's answer to the question.
PostResponsesRequest:
required:
- responses
type: object
properties:
responses:
type: array
items:
$ref: '#/components/schemas/PostResponse'
description: 'The responses to be added or updated.
All strings in these responses will be trimmed of leading and trailing white space.'
autoCodeTextMatch:
type: boolean
description: 'If true, this will attempt to AutoCode responses based on an exact (but case insensitive) text match with previously-coded responses.
This AutoCode will execute first, followed by (if requested) Input ID matching and Regular Expression matching.'
autoCodeInputId:
type: boolean
description: 'If set to True, it will attempt to Auto Code based on a code''s Input ID (Closed ends and Other Specifies only).
This AutoCode will execute after the Text Match and before the Regular Expression match, if either is requested.'
autoC
# --- truncated at 32 KB (49 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/voxco/refs/heads/main/openapi/voxco-responses-api-openapi.yml