Skip to content
SurveyRock Support

List version history

GET
/version/{id}/versions
curl --request GET \
  --url 'https://app.surveyrock.com/api/v1/version/example/versions?limit=50' \
  --header 'Authorization: Bearer <token>'

Returns the version history for a survey, including version number, publish timestamp, and publishing user.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Survey ID

Query Parameters

Section titled “Query Parameters”
limit
integer
default: 50 >= 1 <= 100

Maximum number of versions to return

Responses

Section titled “Responses”

200

Section titled “200”

Version history

Media typeapplication/json
object
success
boolean
data
Array<object>
object
id
string
versionNumber
integer
publishedAt
string format: date-time
publishedBy
string
publishedByEmail
string
changeSummary
object
meta

Standard response metadata

object
timestamp

Response timestamp in ISO 8601 format

string format: date-time
version

API version

string
requestId

Unique request identifier

string
etag

The resource’s ETag, on a read, create or update of a survey, element, rating or NPS question, distributor or contact. The same value as the ETag response header. Treat it as opaque and send it back as If-Match on the next update.

string
Example
{
  "success": true,
  "meta": {
    "version": "3.0"
  }
}

404

Section titled “404”

Survey not found

Media typeapplication/json

Standard error response format

object
success
boolean
error
object
code

Stable, snake_case domain code – see ApiErrorHandler::EXCEPTION_MAP and DomainException

string
message

Human-readable error message

string
suggestion

Imperative recovery hint for this domain code – see ApiErrorHandler::DOMAIN_CODE_SUGGESTIONS

string
retryable

Whether retrying the identical request might succeed without any change on the caller’s end

boolean
details

Additional, code-specific error details

object
meta

Standard response metadata

object
timestamp

Response timestamp in ISO 8601 format

string format: date-time
version

API version

string
requestId

Unique request identifier

string
etag

The resource’s ETag, on a read, create or update of a survey, element, rating or NPS question, distributor or contact. The same value as the ETag response header. Treat it as opaque and send it back as If-Match on the next update.

string
Example
{
  "success": false,
  "error": {
    "code": "survey_not_found"
  },
  "meta": {
    "version": "3.0"
  }
}