GET /external/api/v3/rating

Get ratings for approved customers.

Request Information

URI Parameters

NameDescriptionTypeAdditional informationNullable
ReviewApprovedDateFilter

DateFilter

Required

False
ConcatAnswersForQuestionIds

Collection of integer

None

False
DataFilters

Collection of CustomerDataFilter

None

False
Cursor

Token to retrieve the next set of data. Token can be found in the NextCursor property of the result. Leave empty for the first cursor.

string

None

False
Limit

Total requested. Max and default are set at 100.

integer

None

False

Body Parameters

None.

Response Information

Resource Description

GetRatingResponse
NameDescriptionTypeAdditional informationNullable
Ratings

Collection of Rating

None

False
NextCursor

Token to retrieve the next set of customers - Add token to the Cursor property of the request.

string

None

False

Response Formats

application/json, text/json

Sample:
{
  "Ratings": [
    {
      "Id": 1,
      "TransactionDate": "2024-11-21T09:44:58.0594571+01:00",
      "FinishedDate": "2024-11-21T09:44:58.0594571+01:00",
      "ReviewApprovedDate": "2024-11-21T09:44:58.0594571+01:00",
      "Data": [
        {
          "DisplayName": "sample string 1",
          "Value": "sample string 2"
        },
        {
          "DisplayName": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "Answers": [
        {
          "QuestionId": 1,
          "Description": "sample string 2",
          "Text": "sample string 3",
          "Score": 1
        },
        {
          "QuestionId": 1,
          "Description": "sample string 2",
          "Text": "sample string 3",
          "Score": 1
        }
      ],
      "Reactions": [
        {
          "UserName": "sample string 1",
          "Date": "2024-11-21T09:44:58.0594571+01:00",
          "Reaction": "sample string 3"
        },
        {
          "UserName": "sample string 1",
          "Date": "2024-11-21T09:44:58.0594571+01:00",
          "Reaction": "sample string 3"
        }
      ]
    },
    {
      "Id": 1,
      "TransactionDate": "2024-11-21T09:44:58.0594571+01:00",
      "FinishedDate": "2024-11-21T09:44:58.0594571+01:00",
      "ReviewApprovedDate": "2024-11-21T09:44:58.0594571+01:00",
      "Data": [
        {
          "DisplayName": "sample string 1",
          "Value": "sample string 2"
        },
        {
          "DisplayName": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "Answers": [
        {
          "QuestionId": 1,
          "Description": "sample string 2",
          "Text": "sample string 3",
          "Score": 1
        },
        {
          "QuestionId": 1,
          "Description": "sample string 2",
          "Text": "sample string 3",
          "Score": 1
        }
      ],
      "Reactions": [
        {
          "UserName": "sample string 1",
          "Date": "2024-11-21T09:44:58.0594571+01:00",
          "Reaction": "sample string 3"
        },
        {
          "UserName": "sample string 1",
          "Date": "2024-11-21T09:44:58.0594571+01:00",
          "Reaction": "sample string 3"
        }
      ]
    }
  ],
  "NextCursor": "sample string 1"
}

application/xml, text/xml

Sample:
<GetRatingResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.V2.Responses">
  <NextCursor xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Domain.Shared.Responses">sample string 1</NextCursor>
  <Ratings xmlns:d2p1="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Models">
    <d2p1:Rating>
      <d2p1:Answers>
        <d2p1:RatingAnswer>
          <d2p1:Description>sample string 2</d2p1:Description>
          <d2p1:QuestionId>1</d2p1:QuestionId>
          <d2p1:Score>1</d2p1:Score>
          <d2p1:Text>sample string 3</d2p1:Text>
        </d2p1:RatingAnswer>
        <d2p1:RatingAnswer>
          <d2p1:Description>sample string 2</d2p1:Description>
          <d2p1:QuestionId>1</d2p1:QuestionId>
          <d2p1:Score>1</d2p1:Score>
          <d2p1:Text>sample string 3</d2p1:Text>
        </d2p1:RatingAnswer>
      </d2p1:Answers>
      <d2p1:Data>
        <d2p1:RatingData>
          <d2p1:DisplayName>sample string 1</d2p1:DisplayName>
          <d2p1:Value>sample string 2</d2p1:Value>
        </d2p1:RatingData>
        <d2p1:RatingData>
          <d2p1:DisplayName>sample string 1</d2p1:DisplayName>
          <d2p1:Value>sample string 2</d2p1:Value>
        </d2p1:RatingData>
      </d2p1:Data>
      <d2p1:FinishedDate>2024-11-21T09:44:58.0594571+01:00</d2p1:FinishedDate>
      <d2p1:Id>1</d2p1:Id>
      <d2p1:Reactions>
        <d2p1:RatingReaction>
          <d2p1:Date>2024-11-21T09:44:58.0594571+01:00</d2p1:Date>
          <d2p1:Reaction>sample string 3</d2p1:Reaction>
          <d2p1:UserName>sample string 1</d2p1:UserName>
        </d2p1:RatingReaction>
        <d2p1:RatingReaction>
          <d2p1:Date>2024-11-21T09:44:58.0594571+01:00</d2p1:Date>
          <d2p1:Reaction>sample string 3</d2p1:Reaction>
          <d2p1:UserName>sample string 1</d2p1:UserName>
        </d2p1:RatingReaction>
      </d2p1:Reactions>
      <d2p1:ReviewApprovedDate>2024-11-21T09:44:58.0594571+01:00</d2p1:ReviewApprovedDate>
      <d2p1:TransactionDate>2024-11-21T09:44:58.0594571+01:00</d2p1:TransactionDate>
    </d2p1:Rating>
    <d2p1:Rating>
      <d2p1:Answers>
        <d2p1:RatingAnswer>
          <d2p1:Description>sample string 2</d2p1:Description>
          <d2p1:QuestionId>1</d2p1:QuestionId>
          <d2p1:Score>1</d2p1:Score>
          <d2p1:Text>sample string 3</d2p1:Text>
        </d2p1:RatingAnswer>
        <d2p1:RatingAnswer>
          <d2p1:Description>sample string 2</d2p1:Description>
          <d2p1:QuestionId>1</d2p1:QuestionId>
          <d2p1:Score>1</d2p1:Score>
          <d2p1:Text>sample string 3</d2p1:Text>
        </d2p1:RatingAnswer>
      </d2p1:Answers>
      <d2p1:Data>
        <d2p1:RatingData>
          <d2p1:DisplayName>sample string 1</d2p1:DisplayName>
          <d2p1:Value>sample string 2</d2p1:Value>
        </d2p1:RatingData>
        <d2p1:RatingData>
          <d2p1:DisplayName>sample string 1</d2p1:DisplayName>
          <d2p1:Value>sample string 2</d2p1:Value>
        </d2p1:RatingData>
      </d2p1:Data>
      <d2p1:FinishedDate>2024-11-21T09:44:58.0594571+01:00</d2p1:FinishedDate>
      <d2p1:Id>1</d2p1:Id>
      <d2p1:Reactions>
        <d2p1:RatingReaction>
          <d2p1:Date>2024-11-21T09:44:58.0594571+01:00</d2p1:Date>
          <d2p1:Reaction>sample string 3</d2p1:Reaction>
          <d2p1:UserName>sample string 1</d2p1:UserName>
        </d2p1:RatingReaction>
        <d2p1:RatingReaction>
          <d2p1:Date>2024-11-21T09:44:58.0594571+01:00</d2p1:Date>
          <d2p1:Reaction>sample string 3</d2p1:Reaction>
          <d2p1:UserName>sample string 1</d2p1:UserName>
        </d2p1:RatingReaction>
      </d2p1:Reactions>
      <d2p1:ReviewApprovedDate>2024-11-21T09:44:58.0594571+01:00</d2p1:ReviewApprovedDate>
      <d2p1:TransactionDate>2024-11-21T09:44:58.0594571+01:00</d2p1:TransactionDate>
    </d2p1:Rating>
  </Ratings>
</GetRatingResponse>

Response Status Codes

Status Code Name Description
200 OK The request has succeeded.
400 Bad Request Fulfilling the request would cause an invalid state. Request needs modification.
401 Unauthorized Missing or invalid authentication token.
403 Forbidden Server refuses to authorize the request.
408 Request Timeout The server timed out waiting for the request.
429 Too Many Requests Too many requests in a given amount of time.
500 Internal Server Error The server encountered an unexpected condition which prevented it from fulfilling the request.
503 Service Unavailable The server is unable to proces the request at the moment, try again later.