Feedback | Chipp Docs

Feedback

Retrieve message ratings from your Chipp app consumers

1 min read

# api # builder-api # rest # feedback # ratings # thumbs-up # thumbs-down

Feedback captures consumer ratings on individual messages. Consumers can rate messages as positive (+1), neutral (0), or negative (-1).

List Feedback

plaintext

GET /api/v1/apps/{appId}/feedback

Returns a paginated list of feedback entries, newest first. Uses offset-based pagination.

Query Parameters

Parameter	Type	Default	Description
`limit`	integer	25	Results per page (1-100)
`offset`	integer	0	Number of results to skip
`rating`	integer	—	Filter by rating: `-1`, `0`, or `1`
`session_id`	UUID	—	Filter by session
`created_after`	ISO 8601	—	Feedback created after this date
`created_before`	ISO 8601	—	Feedback created before this date

Example

bash

curl "https://build.chipp.ai/api/v1/apps/YOUR_APP_ID/feedback?limit=20" \
  -H "Authorization: Bearer chipp_YOUR_API_KEY"

Response

json

{
  "data": [
    {
      "id": "fb-001",
      "session_id": "550e8400-e29b-41d4-a716-446655440000",
      "message_id": "msg-002",
      "consumer_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "rating": 1,
      "message_preview": "Welcome! Here's how to get started...",
      "created_at": "2025-06-15T14:45:00Z"
    },
    {
      "id": "fb-002",
      "session_id": "660f9511-f30c-52e5-b827-557766551111",
      "message_id": "msg-014",
      "consumer_id": "8d0f7780-8536-51f6-c928-668877662222",
      "rating": -1,
      "message_preview": "I'm not sure about that. Let me...",
      "created_at": "2025-06-14T09:20:00Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "total": 87,
    "limit": 20,
    "offset": 0
  }
}

Response Fields

Field	Type	Description
`id`	string	Unique feedback identifier
`session_id`	UUID	The session this feedback belongs to
`message_id`	string	The message that was rated
`consumer_id`	UUID	The consumer who submitted the feedback
`rating`	integer	`-1` (negative), `0` (neutral), or `1` (positive)
`message_preview`	string or null	Truncated preview of the rated message (max 200 characters). Null when the referenced message no longer exists
`created_at`	ISO 8601	When the feedback was submitted

Filtering Negative Feedback

To find messages that need improvement:

bash

curl "https://build.chipp.ai/api/v1/apps/YOUR_APP_ID/feedback?rating=-1" \
  -H "Authorization: Bearer chipp_YOUR_API_KEY"

Feedback for a Specific Session

bash

curl "https://build.chipp.ai/api/v1/apps/YOUR_APP_ID/feedback?session_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer chipp_YOUR_API_KEY"