TheTVDB Updates API

openapi: 3.2.0
info:
  description: Documentation of TheTVDB API V4.
  title: TVDB API V4 Updates API
  version: 4.7.10
  x-last-validated: '2026-05-30'
  x-spec-source: https://github.com/thetvdb/v4-api/blob/main/docs/swagger.yml
servers:
- url: https://api4.thetvdb.com/v4
  description: TheTVDB v4 API production
security:
- bearerAuth: []
tags:
- name: Updates
paths:
  /updates:
    get:
      description: Returns updated entities. methodInt indicates a created record (1), an updated record (2), or a deleted record (3). If a record is deleted because it was a duplicate of another record, the target record's information is provided in mergeToType and mergeToId.
      operationId: updates
      parameters:
      - in: query
        name: since
        required: true
        schema:
          type: number
        example: 1.0
      - in: query
        name: type
        required: false
        schema:
          type: string
          enum:
          - artwork
          - award_nominees
          - companies
          - episodes
          - lists
          - people
          - seasons
          - series
          - seriespeople
          - artworktypes
          - award_categories
          - awards
          - company_types
          - content_ratings
          - countries
          - entity_types
          - genres
          - languages
          - movies
          - movie_genres
          - movie_status
          - peopletypes
          - seasontypes
          - sourcetypes
          - tag_options
          - tags
          - translatedcharacters
          - translatedcompanies
          - translatedepisodes
          - translatedlists
          - translatedmovies
          - translatedpeople
          - translatedseasons
          - translatedserierk
          example: movies
        example: movies
      - in: query
        name: action
        required: false
        schema:
          type: string
          enum:
          - delete
          - update
          example: movies
        example: movies
      - description: name
        in: query
        name: page
        schema:
          type: number
        example: 1.0
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/EntityUpdate'
                    type: array
                  status:
                    type: string
                  links:
                    $ref: '#/components/schemas/Links'
                type: object
              examples:
                Updates200Example:
                  summary: Default updates 200 response
                  x-microcks-default: true
                  value:
                    data:
                    - entityType: example
                      methodInt: 1
                      method: example
                      extraInfo: example
                      userId: 12345
                      recordType: example
                      recordId: 12345
                      timeStamp: 12345
                      seriesId: 12345
                      mergeToId: 12345
                      mergeToEntityType: example
                    status: Continuing
                    links:
                      prev: example
                      self: example
                      next: example
                      total_items: 1
                      page_size: 1
        '400':
          description: Invalid since, type param.
        '401':
          description: Unauthorized
      tags:
      - Updates
      summary: TheTVDB Updates
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    EntityUpdate:
      description: entity update record
      properties:
        entityType:
          type: string
          x-go-name: EnitityType
          example: example
        methodInt:
          type: integer
          example: 1
        method:
          type: string
          x-go-name: Method
          example: example
        extraInfo:
          type: string
          example: example
        userId:
          type: integer
          example: 12345
        recordType:
          type: string
          example: example
        recordId:
          format: int64
          type: integer
          x-go-name: RecordID
          example: 12345
        timeStamp:
          format: int64
          type: integer
          x-go-name: TimeStamp
          example: 12345
        seriesId:
          description: Only present for episodes records
          format: int64
          type: integer
          x-go-name: RecordID
          example: 12345
        mergeToId:
          format: int64
          type: integer
          example: 12345
        mergeToEntityType:
          type: string
          example: example
      type: object
      x-go-package: github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model
    Links:
      description: Links for next, previous and current record
      properties:
        prev:
          type:
          - string
          - 'null'
          example: example
        self:
          type:
          - string
          - 'null'
          example: example
        next:
          type: string
          example: example
        total_items:
          type: integer
          example: 1
        page_size:
          type: integer
          example: 1
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT