GET /external/api/v3/rating

Get ratings for approved customers.

Request Information

URI Parameters

Name	Description	Type	Additional information	Nullable
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

Name	Description	Type	Additional information	Nullable
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": "2025-11-05T20:10:14.8225835+01:00",
      "FinishedDate": "2025-11-05T20:10:14.8225835+01:00",
      "ReviewApprovedDate": "2025-11-05T20:10:14.8225835+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": "2025-11-05T20:10:14.8225835+01:00",
          "Reaction": "sample string 3"
        },
        {
          "UserName": "sample string 1",
          "Date": "2025-11-05T20:10:14.8225835+01:00",
          "Reaction": "sample string 3"
        }
      ]
    },
    {
      "Id": 1,
      "TransactionDate": "2025-11-05T20:10:14.8225835+01:00",
      "FinishedDate": "2025-11-05T20:10:14.8225835+01:00",
      "ReviewApprovedDate": "2025-11-05T20:10:14.8225835+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": "2025-11-05T20:10:14.8225835+01:00",
          "Reaction": "sample string 3"
        },
        {
          "UserName": "sample string 1",
          "Date": "2025-11-05T20:10:14.8225835+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>2025-11-05T20:10:14.8225835+01:00</d2p1:FinishedDate>
      <d2p1:Id>1</d2p1:Id>
      <d2p1:Reactions>
        <d2p1:RatingReaction>
          <d2p1:Date>2025-11-05T20:10:14.8225835+01:00</d2p1:Date>
          <d2p1:Reaction>sample string 3</d2p1:Reaction>
          <d2p1:UserName>sample string 1</d2p1:UserName>
        </d2p1:RatingReaction>
        <d2p1:RatingReaction>
          <d2p1:Date>2025-11-05T20:10:14.8225835+01:00</d2p1:Date>
          <d2p1:Reaction>sample string 3</d2p1:Reaction>
          <d2p1:UserName>sample string 1</d2p1:UserName>
        </d2p1:RatingReaction>
      </d2p1:Reactions>
      <d2p1:ReviewApprovedDate>2025-11-05T20:10:14.8225835+01:00</d2p1:ReviewApprovedDate>
      <d2p1:TransactionDate>2025-11-05T20:10:14.8225835+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>2025-11-05T20:10:14.8225835+01:00</d2p1:FinishedDate>
      <d2p1:Id>1</d2p1:Id>
      <d2p1:Reactions>
        <d2p1:RatingReaction>
          <d2p1:Date>2025-11-05T20:10:14.8225835+01:00</d2p1:Date>
          <d2p1:Reaction>sample string 3</d2p1:Reaction>
          <d2p1:UserName>sample string 1</d2p1:UserName>
        </d2p1:RatingReaction>
        <d2p1:RatingReaction>
          <d2p1:Date>2025-11-05T20:10:14.8225835+01:00</d2p1:Date>
          <d2p1:Reaction>sample string 3</d2p1:Reaction>
          <d2p1:UserName>sample string 1</d2p1:UserName>
        </d2p1:RatingReaction>
      </d2p1:Reactions>
      <d2p1:ReviewApprovedDate>2025-11-05T20:10:14.8225835+01:00</d2p1:ReviewApprovedDate>
      <d2p1:TransactionDate>2025-11-05T20:10:14.8225835+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.