Get Survey Response

Retrieve a single survey response by ID.

Endpoint

GET /v1/surveys/{id}/responses/{responseId}

Path Parameters

Parameter	Type	Description
id	integer	Survey ID
responseId	integer	Response ID

Authentication

Requires an API key with the surveys:read scope.

Response

Success (200 OK)

{
  "data": {
    "id": 42,
    "waiver_form_id": 1,
    "booking_id": 123,
    "customer_id": 456,
    "staff_id": null,
    "submission_date": "2026-02-01T10:00:00+00:00",
    "waiver": {
      "id": 1,
      "name": "Customer Satisfaction Survey",
      "type": "survey"
    },
    "customer": {
      "id": 456,
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com"
    },
    "booking": {
      "id": 123,
      "status": "confirmed"
    },
    "responses": [
      {
        "field_id": 10,
        "field_label": "How likely are you to recommend us?",
        "field_type": "npsRating",
        "value": "9"
      },
      {
        "field_id": 11,
        "field_label": "Rate our equipment quality",
        "field_type": "starRating",
        "value": "5"
      },
      {
        "field_id": 12,
        "field_label": "How did you hear about us?",
        "field_type": "singleChoice",
        "value": "Friend referral"
      },
      {
        "field_id": 13,
        "field_label": "Additional comments",
        "field_type": "longText",
        "value": "Excellent service! The staff was very helpful and the equipment was in perfect condition."
      }
    ],
    "nps_score": 9,
    "nps_category": "promoter",
    "created_at": "2026-02-01T10:00:00+00:00"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-01-15T12:00:00+00:00"
  }
}

Response Fields

Field	Type	Description
id	integer	Response ID
waiver_form_id	integer	Survey ID
booking_id	integer	Linked booking ID (if any)
customer_id	integer	Linked customer ID (if any)
staff_id	integer	Staff who collected response (if any)
submission_date	string	ISO 8601 datetime of submission
waiver	object	Survey summary
customer	object	Full customer details (if linked)
booking	object	Booking summary (if linked)
responses	array	All field responses
nps_score	integer	NPS rating value (if survey has NPS field)
nps_category	string	promoter, passive, or detractor
created_at	string	ISO 8601 datetime

Response Field Object

Field	Type	Description
field_id	integer	The survey field ID
field_label	string	The question/label text
field_type	string	Type of field
value	string	The submitted value

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks surveys:read scope
403	forbidden	Survey belongs to another supplier
404	not_found	Survey or response not found

Example Request

curl -X GET "https://app.equipdash.com/api/v1/surveys/1/responses/42" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..."