Need help with Import Response API

Hi Jason, here's a working Python script to import your updated responses via the Qualtrics Response Imports API. This assumes:

• You have your API token and Data Center ID (e.g., ca1, eu1, us2, etc.).

• Your CSV file is properly formatted, matching the survey’s question structure and including the correct Response IDs.

import requests

# === Configuration ===
api_token = 'YOUR_API_TOKEN'
data_center = 'YOUR_DATA_CENTER'  # e.g., 'ca1', 'eu1', 'us2'
survey_id = 'YOUR_SURVEY_ID'
file_path = 'C:/Users/YourName/Downloads/updated_responses.csv'

# === Endpoint ===
url = f'https://{data_center}.qualtrics.com/API/v3/surveys/{survey_id}/import-responses'

# === Headers ===
headers = {
    'x-api-token': api_token,
}

# === File Upload ===
files = {
    'file': ('updated_responses.csv', open(file_path, 'rb'), 'text/csv')
}

# === Make the Request ===
response = requests.post(url, headers=headers, files=files)

# === Handle the Response ===
if response.status_code == 200:
    print('Import request submitted successfully!')
    print('Response:', response.json())
else:
    print(f'Failed to import responses. Status code: {response.status_code}')
    print('Error:', response.text)
 

I am getting a 404 error when using this code ​@rochak_khandelwal 

Hi Jason, thanks for flagging that.

A 404 error from the Qualtrics API occurs when the endpoint URL is incorrect or the resource you're referencing doesn't exist (maybe a wrong survey ID or data center).

Here are a few things which you can try to double-check:

Verify your survey_id
Go to your Qualtrics dashboard → Projects → Select your survey → Click Survey Options → Find the ID in the URL (it starts with SV_).
Ensure that this ID matches exactly in your script.
Confirm your data_center value
You can find this in your account settings:
Go to Account Settings → Qualtrics IDs, and check the Datacenter value.
For example, if your URL is https://ca1.qualtrics.com, then your data_center = 'ca1'.
Check the endpoint construction
The line:
url = f'https://{data_center}.qualtrics.com/API/v3/surveys/{survey_id}/import-responses'

must exactly match the pattern above—with no trailing slashes or typos. A missing or extra / can break it.
Ensure your token has correct permissions
If the API token doesn't have import privileges or access to the given survey, Qualtrics may throw a 404.
If you can share (privately) the actual values you’re using for survey_id and data_center, I can help verify the full URL. Otherwise, just cross-check the structure exactly as above.

Let me know once if you stil face the issue!

Hi @rochak_khandelwal , jasonferns

I’ve tried this importing a CSV file, and am getting a different kind of error when loading it -

‘Unexpected character ('-' (code 45)) in numeric value:’

However a “manual” import of the same file works fine

I can also download SETTINGS file too, but would it work if I were able to specify the SETTINGS file also - perhaps as a header or another file?

I’m using a LOCAL file like this.. it seems to read the file OK but then fall over

files = {'file' : (gFilePath + gFileName, 'text/csv') }

    headers = {
        "content-type": "multipart/form-data",
        "x-api-token": apiToken,
        }
    baseUrl = "https://{0}.qualtrics.com/API/v3/surveys/{1}/import-responses".format(dataCenter, surveyId)

    r = requests.post(baseUrl, data=data, files=files, headers=headers)

Any help with this welcome as the documentation API seems a little scant on settings…

Thanks

James