Start Response Import

POST {{baseUrl}}/surveys/:surveyId/import-responses

Starts an import of a CSV or TSV file. See the Response Import/Export API Overview for more detail on how to use this endpoint within an import workflow.

The API console does not generate code correctly for this endpoint. Use curl for sending requests.

The API console does not render code generation correctly when used to upload CSV or TSV files to this endpoint. Use curl for testing this endpoint.

Import via Locally Hosted File

To import using a locally hosted CSV or TSV file, see this example:

curl --location --request POST 'iad1.qualtrics.com/API/v3/surveys/SV_bwrylOA5nNnI9M1/import-responses' \
  --data-binary '@MyResponses.csv'--header 'Content-Type: text/csv' \
  --header 'charset: UTF-8' \
  --header 'Authorization: Bearer ec9f2045-e33d-4201-80c7-beee28728ef6' 

Import via a File Hosted at a Public URL

To import using a remote, publicly hosted CSV or TSV file, see this example:

curl --location --request POST 'iad1.qualtrics.com/API/v3/surveys/SV_bwrylOA5nNnI9M1/import-responses' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer 8c1e372c-b65a-4ef1-b761-51affbc80216' \
    --data-raw '{
        "format": "csv",
        "fileUrl": "http://myfilehost.com/MyResponses.csv"
    }'

Files Uploaded from a Remote Location Require a Public URL

A CSV or TSV file uploaded from a remote location must be available via a publicly accessible URL.

Request Body

{"format"=>"csv", "fileUrl"=>"<string>", "charset"=>"UTF-8"}

HEADERS

KeyDatatypeRequiredDescription
Idempotency-KeynullIn order to make a request to import a batch of responses idempotent, pass a UUID in this header. Repeated requests with the same Idempotency-Key and the same file will not create duplicate responses.
Qualtrics-Contact-Resolutionnull
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;result&quot;:{&quot;progressId&quot;:&quot;\u003cstring\u003e&quot;,&quot;percentComplete&quot;:&quot;\u003cdouble\u003e&quot;,&quot;status&quot;:&quot;failed&quot;,&quot;continuationToken&quot;:&quot;\u003cstring\u003e&quot;},&quot;meta&quot;:{&quot;requestId&quot;:&quot;\u003cstring\u003e&quot;,&quot;httpStatus&quot;:&quot;\u003cstring\u003e&quot;,&quot;notice&quot;:&quot;\u003cstring\u003e&quot;,&quot;error&quot;:{&quot;errorCode&quot;:&quot;\u003cstring\u003e&quot;,&quot;errorMessage&quot;:&quot;\u003cstring\u003e&quot;}}}