> ## Documentation Index > Fetch the complete documentation index at: https://docs.cevoid.com/llms.txt > Use this file to discover all available pages before exploring further. # Get company review > Returns one company review and its public replies. ## OpenAPI ````yaml /openapi/widget-api.json get /v1/company-reviews/{review_id} openapi: 3.0.3 info: title: Cevoid Widget API version: 1.0.0 servers: - url: https://api.widget.cevoid.com description: Production - url: http://localhost:3007 description: Development security: [] paths: /v1/company-reviews/{review_id}: get: tags: - Reviews summary: Get company review description: Returns one company review and its public replies. parameters: - schema: type: string minLength: 1 maxLength: 200 example: rev_abc123 description: Opaque Cevoid identifier. required: true description: Opaque Cevoid identifier. name: review_id in: path - schema: type: string minLength: 1 maxLength: 200 example: mar_abc123 description: >- Presentation market. Defaults to the workspace default; does not filter collection origin. required: false description: >- Presentation market. Defaults to the workspace default; does not filter collection origin. name: market in: query - schema: type: string enum: - localization example: localization description: >- Include compact original content alongside localized fields. Review reads include reviews, public replies, visible media accessibility text, and returned questions. Summary reads include returned questions only. required: false description: >- Include compact original content alongside localized fields. Review reads include reviews, public replies, visible media accessibility text, and returned questions. Summary reads include returned questions only. name: include in: query responses: '200': description: Successful response headers: Cevoid-Processing-Ms: description: End-to-end request processing time in milliseconds schema: type: string example: '12' Cevoid-Request-Id: description: Request identifier for support and tracing schema: type: string example: req_abc123 RateLimit-Limit: description: Current rate limit bucket size schema: type: string example: '100' RateLimit-Remaining: description: Remaining requests in the current rate limit window schema: type: string example: '99' RateLimit-Reset: description: Seconds until the next request token is available schema: type: integer example: 1 content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/DisplayCompanyReview' included: type: object properties: localization: type: object properties: company_reviews: type: array items: type: object properties: id: type: string minLength: 1 maxLength: 200 example: rev_abc123 description: >- Public ID matching the returned entity or nested item. has_translations: type: boolean example: true description: >- True when the returned translatable content differs from its source representation. Does not mean every field was translated. original: type: object nullable: true properties: title: type: string example: Comfortable everyday fit description: >- Reviewer-supplied headline. In localized responses, title and body both use source text unless a complete translation is available. body: type: string example: Comfortable and true to size. description: >- Reviewer-supplied text. Absent for star-only reviews. In localized responses, title and body both use source text unless a complete translation is available. description: >- Complete source projection of translatable fields, with the same visibility and masking rules. Null when no returned content differs. Not edit history. required: - id - has_translations - original review_responses: type: array items: type: object properties: id: type: string minLength: 1 maxLength: 200 example: rev_abc123 description: >- Public ID matching the returned entity or nested item. has_translations: type: boolean example: true description: >- True when the returned translatable content differs from its source representation. Does not mean every field was translated. original: type: object nullable: true properties: body: type: string example: Comfortable and true to size. description: Reply text as published. required: - body description: >- Complete source projection of translatable fields, with the same visibility and masking rules. Null when no returned content differs. Not edit history. required: - id - has_translations - original review_media: type: array items: type: object properties: id: type: string minLength: 1 maxLength: 200 example: rev_abc123 description: >- Public ID matching the returned entity or nested item. has_translations: type: boolean example: true description: >- True when the returned translatable content differs from its source representation. Does not mean every field was translated. original: type: object nullable: true properties: alt: type: string example: Blue shirt worn outdoors description: >- Available image alternative text, localized with source fallback. thumbnail_alt: type: string example: Blue shirt video preview description: Available video poster alternative text. video_description: type: string example: A shopper shows the fit of a blue shirt. description: Available description of video imagery. video_captions: type: string example: |- WEBVTT 00:00.000 --> 00:01.000 The fit is comfortable. description: >- Available WebVTT captions with cue timing, localized with source fallback. description: >- Complete source projection of translatable fields, with the same visibility and masking rules. Null when no returned content differs. Not edit history. required: - id - has_translations - original questions: type: array items: type: object properties: id: type: string minLength: 1 maxLength: 200 example: rev_abc123 description: >- Public ID matching the returned entity or nested item. has_translations: type: boolean example: true description: >- True when the returned translatable content differs from its source representation. Does not mean every field was translated. original: type: object nullable: true properties: prompt: type: string example: How does it fit? options: type: array items: type: object properties: value: type: string example: blue label: type: string example: Blue required: - value - label description: >- Current selection options. Labels are localized; values remain stable selection keys. scale: type: object properties: start_label: type: string example: Too small end_label: type: string example: Too large center_label: type: string example: Just right step_labels: type: array items: type: string example: Just right required: - start_label - end_label required: - prompt description: >- Complete source projection of translatable fields, with the same visibility and masking rules. Null when no returned content differs. Not edit history. required: - id - has_translations - original required: - localization required: - data example: data: rating: 5 title: Comfortable everyday fit body: Comfortable and true to size. language: en purchase_verification: UNVERIFIED is_incentivized: false is_insider: false channel: IMPORT submitted_at: '2026-09-01T10:00:00.000Z' media: [] answers: [] responses: [] id: crv_abc123 published_at: '2026-09-01T10:00:00.000Z' reviewer: display_name: Jane S included: localization: company_reviews: - id: crv_abc123 has_translations: false original: null review_responses: [] review_media: [] questions: [] '400': description: Bad request headers: Cevoid-Processing-Ms: description: End-to-end request processing time in milliseconds schema: type: string example: '12' Cevoid-Request-Id: description: Request identifier for support and tracing schema: type: string example: req_abc123 RateLimit-Limit: description: Current rate limit bucket size schema: type: string example: '100' RateLimit-Remaining: description: Remaining requests in the current rate limit window schema: type: string example: '99' RateLimit-Reset: description: Seconds until the next request token is available schema: type: integer example: 1 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '401': description: Unauthorized headers: Cevoid-Processing-Ms: description: End-to-end request processing time in milliseconds schema: type: string example: '12' Cevoid-Request-Id: description: Request identifier for support and tracing schema: type: string example: req_abc123 RateLimit-Limit: description: Current rate limit bucket size schema: type: string example: '100' RateLimit-Remaining: description: Remaining requests in the current rate limit window schema: type: string example: '99' RateLimit-Reset: description: Seconds until the next request token is available schema: type: integer example: 1 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '403': description: Forbidden headers: Cevoid-Processing-Ms: description: End-to-end request processing time in milliseconds schema: type: string example: '12' Cevoid-Request-Id: description: Request identifier for support and tracing schema: type: string example: req_abc123 RateLimit-Limit: description: Current rate limit bucket size schema: type: string example: '100' RateLimit-Remaining: description: Remaining requests in the current rate limit window schema: type: string example: '99' RateLimit-Reset: description: Seconds until the next request token is available schema: type: integer example: 1 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '404': description: Not found headers: Cevoid-Processing-Ms: description: End-to-end request processing time in milliseconds schema: type: string example: '12' Cevoid-Request-Id: description: Request identifier for support and tracing schema: type: string example: req_abc123 RateLimit-Limit: description: Current rate limit bucket size schema: type: string example: '100' RateLimit-Remaining: description: Remaining requests in the current rate limit window schema: type: string example: '99' RateLimit-Reset: description: Seconds until the next request token is available schema: type: integer example: 1 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '409': description: Conflict headers: Cevoid-Processing-Ms: description: End-to-end request processing time in milliseconds schema: type: string example: '12' Cevoid-Request-Id: description: Request identifier for support and tracing schema: type: string example: req_abc123 RateLimit-Limit: description: Current rate limit bucket size schema: type: string example: '100' RateLimit-Remaining: description: Remaining requests in the current rate limit window schema: type: string example: '99' RateLimit-Reset: description: Seconds until the next request token is available schema: type: integer example: 1 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '422': description: Validation error headers: Cevoid-Processing-Ms: description: End-to-end request processing time in milliseconds schema: type: string example: '12' Cevoid-Request-Id: description: Request identifier for support and tracing schema: type: string example: req_abc123 RateLimit-Limit: description: Current rate limit bucket size schema: type: string example: '100' RateLimit-Remaining: description: Remaining requests in the current rate limit window schema: type: string example: '99' RateLimit-Reset: description: Seconds until the next request token is available schema: type: integer example: 1 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '429': description: Too many requests headers: Cevoid-Processing-Ms: description: End-to-end request processing time in milliseconds schema: type: string example: '12' Cevoid-Request-Id: description: Request identifier for support and tracing schema: type: string example: req_abc123 RateLimit-Limit: description: Current rate limit bucket size schema: type: string example: '100' RateLimit-Remaining: description: Remaining requests in the current rate limit window schema: type: string example: '99' RateLimit-Reset: description: Seconds until the next request token is available schema: type: integer example: 1 Retry-After: description: Seconds to wait before retrying the request schema: type: integer example: 1 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '500': description: Internal server error headers: Cevoid-Processing-Ms: description: End-to-end request processing time in milliseconds schema: type: string example: '12' Cevoid-Request-Id: description: Request identifier for support and tracing schema: type: string example: req_abc123 RateLimit-Limit: description: Current rate limit bucket size schema: type: string example: '100' RateLimit-Remaining: description: Remaining requests in the current rate limit window schema: type: string example: '99' RateLimit-Reset: description: Seconds until the next request token is available schema: type: integer example: 1 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' security: - BearerAuth: [] components: schemas: DisplayCompanyReview: type: object properties: id: type: string minLength: 1 maxLength: 200 example: rev_abc123 description: Opaque Cevoid identifier. rating: type: integer minimum: 1 maximum: 5 example: 5 description: Score from 1 to 5. title: type: string example: Comfortable everyday fit description: >- Reviewer-supplied headline. In localized responses, title and body both use source text unless a complete translation is available. body: type: string example: Comfortable and true to size. description: >- Reviewer-supplied text. Absent for star-only reviews. In localized responses, title and body both use source text unless a complete translation is available. language: type: string example: en description: >- BCP-47 language of the original submission, even when the returned text is translated. purchase_verification: type: string enum: - VERIFIED - UNVERIFIED example: UNVERIFIED description: Purchase evidence state behind verified-buyer display. is_incentivized: type: boolean example: false description: Whether a reward influenced submission. is_insider: type: boolean example: false description: Whether the reviewer is brand-connected. channel: type: string enum: - REQUEST - WIDGET - LINK - IMPORT - SYNDICATED_IN example: IMPORT description: How the review entered Cevoid. submitted_at: type: string format: date-time example: '2026-09-01T10:00:00.000Z' description: ISO 8601 timestamp when submission completed. published_at: type: string format: date-time example: '2026-09-01T10:00:00.000Z' description: ISO 8601 timestamp when it first became public. edited_at: type: string format: date-time example: '2026-09-01T10:00:00.000Z' description: >- Last reviewer edit; unrelated processing does not change this timestamp. reviewer: type: object properties: display_name: type: string example: Jane S avatar_url: type: string example: https://example.com/reviews/123 required: - display_name media: type: array items: type: object properties: type: type: string enum: - IMAGE - VIDEO example: IMAGE description: Whether the item is an image or a video. url: type: string example: https://example.com/reviews/123 description: Delivery URL for the full asset. thumbnail_url: type: string example: https://example.com/reviews/123 description: Delivery URL for the thumbnail. aspect_ratio: type: number example: 1.5 description: Width divided by height. aspect_ratio_type: type: string enum: - LANDSCAPE - PORTRAIT - SQUARE example: LANDSCAPE description: Coarse orientation bucket. video_length: type: number example: 12 description: Video duration in seconds. id: type: string example: rmed_abc123 description: Stable opaque asset identity shared by detail and preview. alt: type: string example: Blue shirt worn outdoors description: >- Available image alternative text, localized with source fallback. thumbnail_alt: type: string example: Blue shirt video preview description: Available video poster alternative text. video_description: type: string example: A shopper shows the fit of a blue shirt. description: Available description of video imagery. video_captions: type: string example: |- WEBVTT 00:00.000 --> 00:01.000 The fit is comfortable. description: >- Available WebVTT captions with cue timing, localized with source fallback. required: - type - url - thumbnail_url - aspect_ratio - aspect_ratio_type - id answers: type: array items: type: object properties: type: type: string enum: - PRODUCT_ATTRIBUTE - COMPANY_ATTRIBUTE - PROFILE_PROPERTY example: PRODUCT_ATTRIBUTE prompt: type: string example: How does it fit? format: type: string enum: - SCALE - CENTERED_RANGE - SINGLE_SELECT - MULTI_SELECT - WOULD_RECOMMEND - NUMERIC example: SCALE scale: type: object properties: steps: type: number example: 5 start_label: type: string example: Too small end_label: type: string example: Too large center_label: type: string example: Just right step_labels: type: array items: type: string example: Just right required: - steps - start_label - end_label description: >- Current scale size and labels, localized for the selected market. Not a submission-time snapshot. options: type: array items: type: object properties: value: type: string example: blue label: type: string example: Blue required: - value - label description: >- Current selection options. Labels are localized; values remain stable selection keys. numeric: type: object properties: unit: type: string example: cm question_id: type: string minLength: 1 maxLength: 200 example: rvq_abc123 description: Opaque Cevoid identifier. value: anyOf: - type: number example: 4 - type: string example: Comfortable fit - type: boolean example: true - type: array items: type: string example: Comfortable fit required: - type - prompt - format - question_id - value responses: type: array items: type: object properties: id: type: string minLength: 1 maxLength: 200 example: rrsp_abc123 description: Opaque Cevoid identifier. body: type: string example: Comfortable and true to size. created_at: type: string format: date-time example: '2026-09-01T10:00:00.000Z' updated_at: type: string format: date-time example: '2026-09-01T10:00:00.000Z' author: type: object properties: display_name: type: string example: Jane S required: - display_name required: - id - body - created_at - author helpful: type: object properties: up_count: type: number example: 3 down_count: type: number example: 0 required: - up_count required: - id - rating - language - purchase_verification - is_incentivized - is_insider - channel - reviewer - media - answers - responses example: rating: 5 title: Comfortable everyday fit body: Comfortable and true to size. language: en purchase_verification: UNVERIFIED is_incentivized: false is_insider: false channel: IMPORT submitted_at: '2026-09-01T10:00:00.000Z' media: [] answers: [] responses: [] id: crv_abc123 published_at: '2026-09-01T10:00:00.000Z' reviewer: display_name: Jane S ApiErrorResponse: type: object properties: additional_data: type: object additionalProperties: nullable: true description: Optional machine-readable error details. status: type: integer description: HTTP status code. example: 404 code: type: string description: Stable machine-readable error code. example: not_found message: type: string description: Human-readable error description. example: Resource not found request_id: type: string description: Request identifier for support and tracing. example: req_abc123 required: - status - code - message securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: Cevoid publishable key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.