Lists survey responses for the current organization with offset pagination. Results are ordered from newest to oldest. When `operatorId` is provided, only surveys for conversations assigned to that operator are returned. `limit` defaults to `20`, `offset` defaults to `0`, and page navigation metadata is returned in `pagination`. Authenticate with an organization API key sent in `X-API-Key` or as a Bearer token and carrying the exact `surveys:read` scope. API-key access also requires the Automation & API module (`automation_api`). Authorized dashboard sessions remain supported where the route already permits them. The request is isolated to the authenticated organization. Resource and site/project identifiers must belong to that organization; out-of-scope identifiers are not disclosed. Results are ordered newest first and use offset pagination. `limit` defaults to 20, `offset` defaults to 0, and `operatorId` filters through the conversation's assigned operator. Inactive responses can remain stored after a soft delete; clients should rely on the returned collection and pagination rather than inferring deletion semantics from identifiers. Retry behavior: This read-only operation is safe to retry.
/api/surveysOrganization API key supplied as Authorization: Bearer convor_sk_....
In: header
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
{
"data": [
{
"id": "11111111-1111-4111-8111-111111111111",
"orgId": "55555555-5555-4555-8555-555555555555",
"conversationId": "22222222-2222-4222-8222-222222222222",
"visitorId": "33333333-3333-4333-8333-333333333333",
"rating": 3,
"comment": "Very helpful support.",
"createdAt": "2030-06-15T09:15:00.000Z"
}
],
"pagination": {
"totalItems": 1,
"page": 1,
"pageSize": 20,
"hasNextPage": false,
"hasPrevPage": false
}
}{
"error": {
"code": "string",
"message": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"details": {},
"correlationId": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"details": {},
"correlationId": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"details": {},
"correlationId": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"details": {},
"correlationId": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"details": {},
"correlationId": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"details": {},
"correlationId": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"details": {},
"correlationId": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"details": {},
"correlationId": "string"
}
}curl --request GET \
'https://api.convor.io/api/surveys' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer convor_sk_...'const response = await fetch("https://api.convor.io/api/surveys", {
method: "GET",
headers: {
"Accept": "application/json",
"Authorization": "Bearer convor_sk_..."
},
});
const contentType = response.headers.get("content-type") ?? "";
const data = response.status === 204
? null
: contentType.includes("json")
? await response.json()
: contentType.startsWith("text/")
? await response.text()
: await response.blob();
if (!response.ok) {
const message = typeof data === "object" && data !== null
&& "error" in data && typeof data.error === "object"
&& data.error !== null && "message" in data.error
? String(data.error.message)
: "Convor API request failed (" + response.status + ")";
throw new Error(message);
}
console.log(data);Was this page helpful?
List CSAT responses with filtering
Lists CSAT responses for the current organization, sorted newest first. Use optional filters for `rating`, `operatorId`, and `createdAt` range. Pagination uses offset and limit; `limit` defaults to `20`, `offset` defaults to `0`, and `limit` cannot exceed `100`.
Update a survey
Updates one existing survey response in the current organization. The request body is partial, so you can change the rating, the comment, or both without resending unchanged fields. The survey must already exist in the same organization. Use this for back-office corrections rather than new visitor submissions. Authenticate with an organization API key sent in `X-API-Key` or as a Bearer token and carrying the exact `surveys:write` scope. API-key access also requires the Automation & API module (`automation_api`). Authorized dashboard sessions remain supported where the route already permits them. The request is isolated to the authenticated organization. Resource and site/project identifiers must belong to that organization; out-of-scope identifiers are not disclosed. This back-office correction endpoint accepts a partial body containing `rating`, `comment`, or both. Ratings are stable integers from 1 through 3. Visitor submission is intentionally not performed through this operation. The unauthenticated `POST /api/surveys` visitor-token flow is a protocol route and is not part of the organization API-key contract. Retry behavior: Repeating the same request converges on the same resource state, but a retry may return a conflict or not-found response after the first request succeeds.