> ## Documentation Index
> Fetch the complete documentation index at: https://developers.partoo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List review partners

> This endpoint lists the partners whose reviews you can work with, and is the source of the
slugs used in the `partner` field of a review and in the `partner__in` search filter.

It returns:
- `google_my_business` and `facebook`, always,
- `tripadvisor`, when at least one business you have access to is connected to TripAdvisor,
- the **custom partners** enabled on your organization, flagged with `is_custom: true`.

Only the businesses you have `READ` access to and subscribed to review management are taken
into account.




## OpenAPI

````yaml /assets/openapi/openapi-bundled.yaml get /review-partners
openapi: 3.1.0
info:
  title: Partoo Rest API
  version: v2
  license:
    name: © Copyright Partoo
    url: https://www.partoo.co/en/gtu-api/
  x-logo:
    url: >-
      https://partoo-client-images.s3.amazonaws.com/logo-partoo-restapi-white.png
  description: >
    ## Introduction

    The Partoo Rest API allows you to automate all the actions that are possible
    to do in the Partoo Web Application.


    The Partoo Rest API can be used for many different purposes:
      - Create/update/delete your businesses & users if you are a client.
      - Create/subscribe/manage organizations, businesses & users if you are a reseller.
      - Retrieve data on businesses you have access to if you are a publisher.
      - ...
servers:
  - url: https://api.partoo.co/v2
    description: Production server
  - url: https://api.sandbox.partoo.co/v2
    description: Sandbox server (dev environment for clients & partners)
security:
  - ApiKeyAuth: []
paths:
  /review-partners:
    get:
      tags:
        - Reviews
      summary: List review partners
      description: >
        This endpoint lists the partners whose reviews you can work with, and is
        the source of the

        slugs used in the `partner` field of a review and in the `partner__in`
        search filter.


        It returns:

        - `google_my_business` and `facebook`, always,

        - `tripadvisor`, when at least one business you have access to is
        connected to TripAdvisor,

        - the **custom partners** enabled on your organization, flagged with
        `is_custom: true`.


        Only the businesses you have `READ` access to and subscribed to review
        management are taken

        into account.
      operationId: listReviewPartners
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  partners:
                    type: array
                    description: Partners available to you
                    items:
                      $ref: '#/components/schemas/ReviewPartner'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
components:
  schemas:
    ReviewPartner:
      description: A partner reviews can come from
      type: object
      properties:
        slug:
          type: string
          description: >
            Unique identifier of the partner. This is the value carried by a
            review's `partner`

            field, and the one accepted by the `partner__in` search filter.
          example: google_my_business
        display_name:
          type: string
          description: Name of the partner, as displayed in the Partoo app
          example: Google
        is_custom:
          type: boolean
          description: >
            `true` for a custom partner, whose reviews your organization pushes
            through the API.

            `false` for a partner Partoo synchronizes natively.
          example: false
  responses:
    '401':
      description: You are not authenticated
      content:
        application/json:
          schema:
            description: Error that occurs when you are not authenticated
            type: object
            properties:
              errors:
                type: object
                description: The detail of the error encountered
                properties:
                  authentication:
                    type: string
                    default: User not authenticated
    '403':
      description: |
        You are not allowed to perform this action
      content:
        application/json:
          schema:
            description: >
              Error that occurs when you are authenticated but you are trying to
              perform an action you are not allowed to perform
            type: object
            properties:
              errors:
                type: object
                description: The detail of the error encountered
                properties:
                  authorization:
                    type: string
                    default: Operation not allowed
  securitySchemes:
    ApiKeyAuth:
      description: >
        The authentication system on Partoo API is using API Key that should be
        put in the header of the request (the name of the header is `x-APIKey`).
        An api_key is linked to a user. This user's role will give you different
        access level to the API features.
      type: apiKey
      in: header
      name: x-APIKey

````