The Response resource

Every response that leaves Usertick has the same shape. The REST API returns it, every webhook delivery that carries a response has it in data, and the Zapier app outputs it, so code that handles one source handles all of them.

{
  "id": "9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
  "url": "https://app.usertick.com/inbox/9b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
  "survey": { "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "name": "Checkout feedback" },
  "site": { "id": "22222222-2222-4222-8222-222222222222", "domain": "shop.example.com" },
  "createdAt": "2026-09-30T10:00:00.123Z",
  "updatedAt": "2026-09-30T12:31:05.120Z",
  "source": "widget",
  "language": "en",
  "country": "US",
  "pageUrl": "https://shop.example.com/checkout",
  "device": { "type": "desktop", "browser": "Chrome", "os": "macOS" },
  "variant": null,
  "variantName": null,
  "contact": { "id": "33333333-3333-4333-8333-333333333333", "email": "[email protected]" },
  "respondent": {
    "userId": "user_8271",
    "anonymousId": "5f0c7a2b-8d4e-4c1a-9e3f-2b6d8a0c4e1f",
    "verified": true,
    "email": "[email protected]",
    "emailSource": "identify",
    "name": "Maya Chen",
    "company": "Example Inc.",
    "traits": { "company": "Example Inc.", "plan": "pro" },
    "traitsVerified": false,
    "contactQuestion": null,
    "contact": { "id": "33333333-3333-4333-8333-333333333333" }
  },
  "answers": [
    {
      "questionId": "4b1c2d3e-0000-4a5b-8c9d-0e1f2a3b4c5d",
      "question": "How likely are you to recommend us?",
      "type": "nps",
      "value": 4,
      "text": "4"
    },
    {
      "questionId": "9e8d7c6b-0000-4a5b-8c9d-0e1f2a3b4c5d",
      "question": "What went wrong?",
      "type": "text",
      "value": "Checkout rejects my card every time",
      "text": "Checkout rejects my card every time"
    }
  ],
  "answerText": {
    "4b1c2d3e-0000-4a5b-8c9d-0e1f2a3b4c5d": "4",
    "9e8d7c6b-0000-4a5b-8c9d-0e1f2a3b4c5d": "Checkout rejects my card every time"
  },
  "attachments": [],
  "status": "in_progress",
  "assignees": [
    { "id": "66666666-6666-4666-8666-666666666666", "name": "Ana Ruiz", "email": "[email protected]" }
  ],
  "ai": {
    "type": "bug",
    "urgency": "high",
    "theme": { "id": "44444444-4444-4444-8444-444444444444", "name": "Checkout errors" },
    "category": { "id": "55555555-5555-4555-8555-555555555555", "name": "Payments" },
    "sentiment": "negative",
    "analyzedAt": "2026-09-30T10:00:07.250Z",
    "corrected": false
  },
  "commentsCount": 2
}

Fields

string

The response id, a UUID.

string

A link that opens the response in your Usertick inbox.

object

{ id, name }. Usertick doesn’t return or send the responses of a deleted survey, so name is null only when the survey is deleted while the response is being read.

object | null

{ id, domain }, the website the response came from. Null for link, QR and email surveys.

string

When the response was received.

string

The latest of: when it was received, when it was analyzed, and the last change a person or an integration made to its status, type, urgency, assignees, notes or analysis. Use it with updatedSince to keep a copy in sync.

string | null

How it was collected: widget, link, email or api.

string | null

The language the respondent answered in.

string | null

Two letter country code (ISO 3166-1).

string | null

The page the response was sent from.

object | null

{ type, browser, os }. type is desktop, tablet or mobile: the device class the widget used for device targeting, or null for a response that carries none. Null when nothing is known.

string | null

The ID of the survey variant the respondent saw, such as v_k3x9. Null when the respondent saw no variant: on a survey without variants, or in Everyone else.

string | null

The name of the variant in variant, as the survey names it. A variant removed from the survey keeps its name here. Null when variant is null or the variant has no name.

object | null

{ id, email }, the Usertick contact the response is linked to. Without a linked contact, id is null and email is the respondent’s email (respondent.email). Null when neither is known. Webhook deliveries carry the same as API reads. See how a response links to a contact.

object

Who answered, from Usertick.identify(), a Contact question and the contact the response is linked to. The object is always present, and a field in it is null when it isn’t known. Usertick never sends it to the AI.

Show respondent

string | null

Your own user id, as the page sent it with identify().

string | null

The browser’s random visitor id. A new one starts after a logout, so it doesn’t follow a person across logins. Null for link and email responses sent without one.

boolean

True when a valid user hash from your server came with the response.

string | null

The respondent’s email, in this order: the contact an email campaign was sent to, a verified email from identify(), a Contact question, an email from identify() without a valid hash. An answer to any other question type is never taken as the email.

string | null

Where email came from: campaign, identify or contact_question.

string | null

The name identify() sent.

string | null

The company identify() sent.

object

The other traits identify() sent, a flat object of strings, numbers and booleans. {} without any.

boolean

True when every trait came signed in the token.

object | null

What the respondent typed into a Contact question: the fields with a value, out of name, email, phone, company and message. Null without one.

object | null

{ id }, the contact the response is linked to.

array

The answered questions, in survey order. Answers to questions the survey no longer has come last.

Show answer

string

The question’s id. GET /surveys/{surveyId} lists the questions.

string | null

The question’s text. Null for a question the survey no longer has.

string | null

The question type, for example nps, rating, multiple_choice or text.

any

The answer as the respondent sent it: a number, a string, a boolean, an array or an object, depending on the question type.

string

The answer as a person reads it. Choice labels are joined by ”, ”, a yes or no question reads Yes or No, and a number stays a number. A choice whose option was later deleted from the question keeps the label the option had.

object

The same text values keyed by question id, which lets an automation map one answer to one field.

array

Files the respondent sent, such as uploads, screenshots and signatures: { id, questionId, name, url }. See Download files.

string

The inbox status: open, planned, in_progress, resolved or archived.

array

The members assigned to the response: { id, name, email }.

object | null

What Usertick AI read in the response, with any correction a person made folded in. Null until the response is analyzed, when the analysis was skipped or failed and nobody corrected it, and on every response.created delivery.

Show ai

string | null

The feedback type of the strongest answer, or the type a person set: bug, idea, complaint, question or praise.

string | null

high, medium or low.

object | null

{ id, name }. The ids match the analysis tree. Null when the tree no longer has the theme.

object | null

{ id, name }, the same way.

string | null

negative, neutral or positive.

string | null

When the analysis ran. Null when the values come only from a person’s correction.

boolean

True when a person changed one of these values. Their value wins over the AI’s.

integer

Notes on the response’s timeline. Deleted notes are not counted.

Behavior

Every key is always present, and an empty value is null. The one exception is change, described below.
To find one person’s responses, list responses with userId, which matches your user id exactly, or with email, which matches an answer that is exactly that address, the email identify() sent, or the contact with that email and the responses linked to it.
Question texts and choice labels come from the published survey, in English when the survey has it, otherwise in its first language.
New fields can be added within v1, so your code should ignore the ones it doesn’t know. See Versioning.
In a webhook delivery, status, assignees and commentsCount are read when the delivery is sent. The answers and the analysis are those of the event.
response.status_changed and response.classification_corrected deliveries, and the status changes that GET /responses/recent lists, add a change key with the field that changed, its old and new value, and who changed it. See What changed.
To drop duplicate webhook deliveries, compare the delivery’s id or the webhook-id header instead of the response id. See Delivery and retries.

JavaScript SDK

REST API

API reference

Webhooks

MCP

The Response resource

Fields

Behavior

​Fields

​Behavior

Fields

Behavior