Get Feedback

curl https://api.thanxsandbox.com/feedbacks/590485d6f0 \
  -X PATCH \
  -H "Content-Type: application/json"  \
  -H "Accept-Version: v4.0" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ${token}" \
  -H "X-ClientId: ${client_id}" 
  -d '{
    "feedback": {
      "rating": 10,
      "review": "Lorem ipsum dolor sit amet"
    }
  }'

{
  "feedback": {
    "id": "590485d6f0",
    "user_id": "fsjlk",
    "merchant_id": "woeri34",
    "location_id": "fgr2349gh",
    "state": "unviewed",
    "expires_at": "2020-01-07T20:00:00Z",
    "rating": null,
    "review": null,
    "response": null,
    "purchase": {
      "id": "916895d48a",
      "purchased_at": "2020-01-01T20:00:00Z",
      "amount": 16.0,
      "order": {
        "id": "aepo3cme2p",
        "provider": "Toast"
      }
    }
  }
}

GET

feedbacks

:id

curl https://api.thanxsandbox.com/feedbacks/590485d6f0 \
  -X PATCH \
  -H "Content-Type: application/json"  \
  -H "Accept-Version: v4.0" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ${token}" \
  -H "X-ClientId: ${client_id}" 
  -d '{
    "feedback": {
      "rating": 10,
      "review": "Lorem ipsum dolor sit amet"
    }
  }'

{
  "feedback": {
    "id": "590485d6f0",
    "user_id": "fsjlk",
    "merchant_id": "woeri34",
    "location_id": "fgr2349gh",
    "state": "unviewed",
    "expires_at": "2020-01-07T20:00:00Z",
    "rating": null,
    "review": null,
    "response": null,
    "purchase": {
      "id": "916895d48a",
      "purchased_at": "2020-01-01T20:00:00Z",
      "amount": 16.0,
      "order": {
        "id": "aepo3cme2p",
        "provider": "Toast"
      }
    }
  }
}

If the user is no longer able to leave feedback for this purchase, a 404 will be returned instead.

Please review proper request headers here.

Parameters

string

required

The feedback id

Response

string

The ID of the feedback record

string

The user ID

string

The merchant ID

string

Location ID

enum

The state of the feedback record

unviewed - User has an opportunity to leave feedback for a purchase they have made, but has not been displayed the feedback prompt yet.
viewed - User viewed the opportunity to leave feedback, but they have not left a NPS or review yet.
expired - User did not leave a NPS or review before the feedback expired
rated - User has left a net promoter score
reviewed - User has left a review
responded - Merchant has responded to the user's feedback

string

The feedback expiration time in ISO8601-format. Users cannot submit a rating or review for the associated purchase after this time has elapsed.

string

The ISO8601 timestamp of the purchase the feedback was associated with.

string

The ISO8601 timestamp the feedback was viewed by the consumer

string

The ISO8601 timestamp the feedback was rated by the consumer

string

The ISO8601 timestamp the feedback was reviewed by the consumer

string

The ISO8601 timestamp the feedback was responded to by the merchant

integer

NPS score (null or 1-10)

string

Customer feedback

string

Merchant response

hash

The associated purchase record

Show purchase

string

Purchase ID

string

Time the purchase was made in ISO8601-format

decimal

Purchase amount

hash

Provides information about the associated order, if any

Show order

string

The ID of the order in the provider's system

enum

The online ordering provider (OLO, Toast, Other)

curl https://api.thanxsandbox.com/feedbacks/590485d6f0 \
  -X PATCH \
  -H "Content-Type: application/json"  \
  -H "Accept-Version: v4.0" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ${token}" \
  -H "X-ClientId: ${client_id}" 
  -d '{
    "feedback": {
      "rating": 10,
      "review": "Lorem ipsum dolor sit amet"
    }
  }'

{
  "feedback": {
    "id": "590485d6f0",
    "user_id": "fsjlk",
    "merchant_id": "woeri34",
    "location_id": "fgr2349gh",
    "state": "unviewed",
    "expires_at": "2020-01-07T20:00:00Z",
    "rating": null,
    "review": null,
    "response": null,
    "purchase": {
      "id": "916895d48a",
      "purchased_at": "2020-01-01T20:00:00Z",
      "amount": 16.0,
      "order": {
        "id": "aepo3cme2p",
        "provider": "Toast"
      }
    }
  }
}

Get Feedbacks Update Feedback

⌘I

Consumer API

Reference

Get Feedback

Parameters

Response

​Parameters

​Response

Parameters

Response