> ## 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 Entity Item Review > Gets the submitted review for the specified item by the authenticated entity. 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/GetEntityItemReview 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/GetEntityItemReview: post: tags: - Catalog summary: Get Entity Item Review description: > Gets the submitted review for the specified item by the authenticated entity. 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: GetEntityItemReview requestBody: content: application/json: schema: $ref: '#/components/schemas/GetEntityItemReviewRequest' responses: '200': $ref: '#/components/responses/GetEntityItemReviewResponse' '400': $ref: '#/components/responses/ApiErrorWrapper' security: - EntityToken: [] components: schemas: GetEntityItemReviewRequest: type: object properties: AlternateId: allOf: - $ref: '#/components/schemas/CatalogAlternateId' description: An alternate ID associated with this item. CustomTags: description: >- The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). type: object Entity: allOf: - $ref: '#/components/schemas/EntityKey' description: The entity to perform this action on. Id: description: The unique ID of the item. type: string example: 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 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 GetEntityItemReviewResponse: type: object properties: Review: allOf: - $ref: '#/components/schemas/Review' description: The review the entity submitted for the requested item. example: Review: 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' 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 responses: GetEntityItemReviewResponse: 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/GetEntityItemReviewResponse' example: code: 200 status: OK data: Review: 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' 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 Entity Item Review](/services/playfab/api-references/rest/economy/catalog/get-entity-item-review.md) - [PFCatalogGetEntityItemReviewAsync](/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentityitemreviewasync.md) - [PFCatalogGetEntityItemReviewRequest](/services/playfab/api-references/c/pfcatalogtypes/structs/pfcataloggetentityitemreviewrequest.md) - [PFCatalogGetEntityItemReviewResponse](/services/playfab/api-references/c/pfcatalogtypes/structs/pfcataloggetentityitemreviewresponse.md) - [PFCatalogGetEntityItemReviewGetResult](/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentityitemreviewgetresult.md)