> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Item Reviews > Get a paginated set of reviews associated with the specified item. Individual ratings and reviews data update in near real time with delays within a few seconds. Allowed entity token types: title, master_player_account, title_player_account ## Error codes This operation may return the following PlayFab errors: | Error | Code | | --- | --- | | DatabaseThroughputExceeded | 1113 | | ItemNotFound | 1047 | ## OpenAPI ````yaml /services/playfab/api-references/rest/economy/economy.openapi.json post /Catalog/GetItemReviews openapi: 3.0.0 info: version: '260922' title: PlayFab Economy API description: >- API methods for managing the catalog. Inventory manages in-game assets for any given entity. API methods for managing the versioned catalogs. termsOfService: https://playfab.com/terms/ contact: url: https://community.playfab.com/index.html license: name: Apache 2.0 url: https://github.com/PlayFab/API_Specs/blob/master/LICENSE servers: - url: https://{titleId}.playfabapi.com description: PlayFab title endpoint variables: titleId: default: your_title_id description: Your PlayFab title ID (hex). security: [] tags: - name: Catalog description: |- Catalog Management APIs. In general for Catalog APIs, Read APIs are limited to 100 requests in 60 seconds for Player Entities while Title Entities are limited to 10000 requests in 10 seconds. For Write APIs, Player Entities are limited to 10 requests in 30 seconds and Title Entities are limited to 1000 requests in 10 seconds. - name: Inventory description: |- Player Inventory Management APIs. Inventory operations work on an eventually consistent system against a cache of the Catalog. It can take a few moments for changes to propagate. In general for Inventory APIs, Read APIs are limited to 100 requests in 60 seconds for Player Entities while Title Entities are limited to 10000 requests in 10 seconds. For Write APIs, Player Entities are limited to 30 requests in 90 seconds and Title Entities are limited to 1000 requests in 10 seconds. - name: VersionedCatalog description: '' paths: /Catalog/GetItemReviews: post: tags: - Catalog summary: Get Item Reviews description: > Get a paginated set of reviews associated with the specified item. Individual ratings and reviews data update in near real time with delays within a few seconds. Allowed entity token types: title, master_player_account, title_player_account ## Error codes This operation may return the following PlayFab errors: | Error | Code | | --- | --- | | DatabaseThroughputExceeded | 1113 | | ItemNotFound | 1047 | operationId: GetItemReviews requestBody: content: application/json: schema: $ref: '#/components/schemas/GetItemReviewsRequest' responses: '200': $ref: '#/components/responses/GetItemReviewsResponse' '400': $ref: '#/components/responses/ApiErrorWrapper' security: - EntityToken: [] components: schemas: GetItemReviewsRequest: type: object properties: AlternateId: allOf: - $ref: '#/components/schemas/CatalogAlternateId' description: An alternate ID associated with this item. ContinuationToken: description: >- An opaque token used to retrieve the next page of items, if any are available. type: string Count: description: >- Number of items to retrieve. This value is optional. Default value is 10. type: number x-actualtype: int32 CustomTags: description: >- The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). type: object Id: description: The unique ID of the item. type: string OrderBy: description: >- An OData orderBy used to order the results of the query. Possible values are Helpfulness, Rating, and Submitted (For example: "Submitted desc") type: string required: - Count example: Count: 2 Top: 10 Id: dddddddd-dddd-dddd-dddd-dddddddddddd CatalogAlternateId: type: object properties: Type: description: Type of the alternate ID. type: string Value: description: Value of the alternate ID. type: string GetItemReviewsResponse: type: object properties: ContinuationToken: description: >- An opaque token used to retrieve the next page of items, if any are available. type: string Reviews: description: The paginated set of results. type: array items: $ref: '#/components/schemas/Review' x-isclass: true example: Reviews: - ReviewId: 372f84cd-b45b-48a7-9549-2c09a6c12104 ItemId: dddddddd-dddd-dddd-dddd-dddddddddddd ReviewerEntity: Id: ABCD1234 Type: title_player_account TypeString: title_player_account ReviewerId: title_player_account!ABCD1234 ItemVersion: 2.1.4 Title: Best game ever ReviewText: I play this game every day. It's so much fun! Rating: 3 IsInstalled: true Locale: en-us HelpfulPositive: 11 HelpfulNegative: 17 Submitted: '2018-08-17T22:32:10.4729879+00:00' - ReviewId: 372f84cd-b45b-48a7-9549-2c09a6c12104 ItemId: dddddddd-dddd-dddd-dddd-dddddddddddd ReviewerEntity: Id: ABCD1234 Type: title_player_account TypeString: title_player_account ReviewerId: title_player_account!ABCD1234 ItemVersion: 2.1.4 Title: Best game ever ReviewText: I play this game every day. It's so much fun! Rating: 3 IsInstalled: true Locale: en-us HelpfulPositive: 11 HelpfulNegative: 17 Submitted: '2018-08-17T22:32:10.4729879+00:00' ContinuationToken: >- +RID:IQkbAIvkRQD9oQIAAAAAAA==#RT:1#TRC:10#FPC:AgEKHAoKAPEhAOAhQP8DWIAMAgB8rRACAJeAHAIA0r0= ApiErrorWrapper: description: The basic wrapper around every failed API response type: object properties: code: description: Numerical HTTP code type: integer status: description: String HTTP code type: string error: description: Playfab error code type: string errorCode: description: Numerical PlayFab error code type: integer errorMessage: description: Description for the PlayFab errorCode type: string errorDetails: description: Detailed description of individual issues with the request object type: object required: - code - errorCode Review: type: object properties: CategoryRatings: description: >- The star rating associated with each selected category in this review. type: object x-actualtype: int32 HelpfulNegative: description: The number of negative helpfulness votes for this review. type: number x-actualtype: int32 HelpfulPositive: description: The number of positive helpfulness votes for this review. type: number x-actualtype: int32 IsInstalled: description: Indicates whether the review author has the item installed. type: boolean ItemId: description: The ID of the item being reviewed. type: string ItemVersion: description: The version of the item being reviewed. type: string Locale: description: The locale for which this review was submitted in. type: string Rating: description: Star rating associated with this review. type: number x-actualtype: int32 ReviewerEntity: allOf: - $ref: '#/components/schemas/EntityKey' description: The ID of the author of the review. ReviewId: description: The ID of the review. type: string ReviewText: description: The full text of this review. type: string Submitted: description: The date and time this review was last submitted. type: string Title: description: The title of this review. type: string required: - Rating - IsInstalled - HelpfulPositive - HelpfulNegative - Submitted EntityKey: description: >- Combined entity type and ID structure which uniquely identifies a single entity. type: object properties: Id: description: Unique ID of the entity. type: string Type: description: >- Entity type. See https://learn.microsoft.com/gaming/playfab/features/data/entities/available-built-in-entity-types type: string required: - Id responses: GetItemReviewsResponse: description: '' content: application/json: schema: type: object properties: code: type: integer description: >- The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code. status: type: string description: The Http status code as a string. data: $ref: '#/components/schemas/GetItemReviewsResponse' example: code: 200 status: OK data: Reviews: - ReviewId: 372f84cd-b45b-48a7-9549-2c09a6c12104 ItemId: dddddddd-dddd-dddd-dddd-dddddddddddd ReviewerEntity: Id: ABCD1234 Type: title_player_account TypeString: title_player_account ReviewerId: title_player_account!ABCD1234 ItemVersion: 2.1.4 Title: Best game ever ReviewText: I play this game every day. It's so much fun! Rating: 3 IsInstalled: true Locale: en-us HelpfulPositive: 11 HelpfulNegative: 17 Submitted: '2018-08-17T22:32:10.4729879+00:00' - ReviewId: 372f84cd-b45b-48a7-9549-2c09a6c12104 ItemId: dddddddd-dddd-dddd-dddd-dddddddddddd ReviewerEntity: Id: ABCD1234 Type: title_player_account TypeString: title_player_account ReviewerId: title_player_account!ABCD1234 ItemVersion: 2.1.4 Title: Best game ever ReviewText: I play this game every day. It's so much fun! Rating: 3 IsInstalled: true Locale: en-us HelpfulPositive: 11 HelpfulNegative: 17 Submitted: '2018-08-17T22:32:10.4729879+00:00' ContinuationToken: >- +RID:IQkbAIvkRQD9oQIAAAAAAA==#RT:1#TRC:10#FPC:AgEKHAoKAPEhAOAhQP8DWIAMAgB8rRACAJeAHAIA0r0= ApiErrorWrapper: description: This is the outer wrapper for all responses with errors content: application/json: schema: $ref: '#/components/schemas/ApiErrorWrapper' securitySchemes: EntityToken: type: apiKey in: header name: X-EntityToken description: >- This API requires an Entity Session Token, available from the Entity GetEntityToken method. ```` ## Related topics - [Get Item Reviews](/services/playfab/api-references/rest/economy/catalog/get-item-reviews.md) - [Get Item Review Summary](/api-reference/catalog/get-item-review-summary.md) - [PFCatalogGetItemReviewsAsync](/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsasync.md) - [PFCatalogGetItemReviewsGetResult](/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsgetresult.md) - [PFCatalogGetItemReviewsRequest](/services/playfab/api-references/c/pfcatalogtypes/structs/pfcataloggetitemreviewsrequest.md)