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

# Get Ratings

> Returns ratings given by the user.

## Usage

Returns the authenticated user's ratings with pagination.

Authentication is required via `x-api-key` or `Authorization: Bearer`.

## Example

```bash theme={null}
curl -H "x-api-key: $DEJAVU_API_KEY" "https://dejavu.plus/api/v1/ratings?page=1&pageSize=20"
```

## Parameters and response

Query parameters and response schemas are defined by the OpenAPI specification displayed on this page. Ratings can apply to movies, TV shows, seasons, or episodes depending on the supplied context.

## Errors

See **Responses** for the operation-specific error codes and formats.


## OpenAPI

````yaml GET /ratings
openapi: 3.1.0
info:
  title: dejaVu API V1
  description: >-
    API publique dejaVu V1 pour intégrer la collection, l’historique, les
    favoris, les notes, la watchlist, le scrobble, les listes, les chaînes, les
    connecteurs et les fonctions d’intégration.
  version: 1.0.0
servers:
  - url: https://dejavu.plus/api/v1
    description: Production
security:
  - ApiKeyHeader: []
  - BearerAuth: []
tags:
  - name: Collection
    description: Gérez votre collection personnelle de films et séries vus ou possédés.
  - name: History
    description: Consultez et gérez votre historique de visionnage.
  - name: Favorites
    description: Ajoutez et retirez des films et séries de vos favoris.
  - name: Ratings
    description: Notez et rédigez des avis sur vos films, séries, saisons et épisodes.
  - name: Watchlist
    description: Gérez votre liste de contenus à regarder.
  - name: Scrobble
    description: Suivez la progression de lecture en temps réel.
  - name: Up Next
    description: Obtenez les prochains épisodes à regarder pour les séries que vous suivez.
  - name: Lists
    description: Créez et gérez des listes personnalisées de films et séries.
  - name: Dashboard
    description: Expose la configuration du tableau de bord et le contenu des widgets.
  - name: User
    description: Informations de compte et statistiques.
  - name: Auth
    description: Authentification des appareils et gestion des jetons.
  - name: Channels
    description: Chaînes et univers accessibles à l’utilisateur.
  - name: Connectors
    description: Connecteurs utilisés par l’extension navigateur.
  - name: Kodi
    description: Import de bibliothèques Kodi.
  - name: Media
    description: Résolution et statut de médias.
paths:
  /ratings:
    get:
      tags:
        - Ratings
      summary: Récupérer les notes
      description: Retourne les notes données par l'utilisateur.
      operationId: getRatings
      parameters:
        - name: type
          in: query
          description: Filtrer par type
          schema:
            type: string
            enum:
              - all
              - movie
              - tv
              - season
              - episode
            default: all
        - name: minimal
          in: query
          description: Retourner uniquement type et id
          schema:
            type: boolean
            default: false
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
          description: Numéro de page (à partir de 1).
          example: 1
        - name: pageSize
          in: query
          schema:
            type: integer
            minimum: 1
          description: Nombre d'éléments par page (1 à 100).
          example: 20
      responses:
        '200':
          description: Liste des notes
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                properties:
                  success:
                    type: boolean
                    default: true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/RatingItem'
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: Authentification absente, invalide ou clé API non autorisée.
      security:
        - ApiKeyHeader: []
        - BearerAuth: []
components:
  schemas:
    RatingItem:
      allOf:
        - $ref: '#/components/schemas/MediaItem'
        - type: object
          properties:
            rating:
              type: integer
              minimum: 1
              maximum: 10
            review:
              type: string
              nullable: true
            ratedAt:
              type: string
              format: date-time
    MediaItem:
      type: object
      properties:
        id:
          type: integer
          description: ID TMDB
        type:
          type: string
          enum:
            - movie
            - tv
        title:
          type: string
        posterPath:
          type: string
          nullable: true
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
          description: Code d'erreur machine-readable
        message:
          type: string
          description: Description lisible de l'erreur
  responses:
    Unauthorized:
      description: >-
        Authentification requise. Utilisez le header x-api-key ou Authorization:
        Bearer <key>.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: UNAUTHORIZED
            message: API key is missing or invalid.
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: Clé API dejaVu. pk_* = lecture seule ; sk_* = lecture et écriture.
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Clé API dejaVu envoyée dans Authorization: Bearer <key>.'

````