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

# List product history

> GET /products/{product_id}/history: who changed what on a product and when, with before and after values. Requires product-history:read.



## OpenAPI

````yaml openapi.json GET /api/public/v1/products/{product_id}/history
openapi: 3.1.0
info:
  title: WISEPIM Public API
  version: 1.0.0
  description: >-
    Manage your WisePIM catalogue, prompts and knowledge, and launch enrichment,
    translation and bulk jobs. Authenticate with `Authorization: Bearer wpk_…`;
    create keys under Settings → API keys. Each key is bound to one project and
    to the scopes it was created with.
  summary: >-
    Manage your catalog, variants, media, relations and pricing; run imports,
    exports, enrichment, translation and bulk actions; follow changes with
    webhooks and the deletion feed.
  termsOfService: https://wisepim.com/terms
  contact:
    name: WISEPIM support
    url: https://wisepim.com/contact
    email: info@wisepim.com
  x-logo:
    url: >-
      https://docs.wisepim.com/logo/wisepim-logo-horizontal-transparant-lightmode.png
    altText: WISEPIM
servers:
  - url: https://wisepim.com
    description: Production. Every path below already starts with /api/public/v1.
security:
  - ProjectApiKeyAuth: []
tags:
  - name: Key and project
    description: Key and project endpoints for the project bound to your API key.
  - name: Products
    description: Products endpoints for the project bound to your API key.
  - name: Variant axes
    description: Variant axes endpoints for the project bound to your API key.
  - name: Categories
    description: Categories endpoints for the project bound to your API key.
  - name: Attributes
    description: Attributes endpoints for the project bound to your API key.
  - name: Dictionary Entries
    description: Dictionary Entries endpoints for the project bound to your API key.
  - name: Keywords
    description: Keywords endpoints for the project bound to your API key.
  - name: Import Templates
    description: Import Templates endpoints for the project bound to your API key.
  - name: Export Templates
    description: Export Templates endpoints for the project bound to your API key.
  - name: Attribute Groups
    description: Attribute Groups endpoints for the project bound to your API key.
  - name: Product Families
    description: Product Families endpoints for the project bound to your API key.
  - name: Value Code Sets
    description: Value Code Sets endpoints for the project bound to your API key.
  - name: Code Set Values
    description: Code Set Values endpoints for the project bound to your API key.
  - name: Uom Code Sets
    description: Uom Code Sets endpoints for the project bound to your API key.
  - name: Uom Values
    description: Uom Values endpoints for the project bound to your API key.
  - name: Prompts
    description: Prompts endpoints for the project bound to your API key.
  - name: Knowledge Libraries
    description: Knowledge Libraries endpoints for the project bound to your API key.
  - name: Enrichments
    description: Enrichments endpoints for the project bound to your API key.
  - name: Translations
    description: Translations endpoints for the project bound to your API key.
  - name: Bulk Actions
    description: Bulk Actions endpoints for the project bound to your API key.
  - name: Jobs
    description: Jobs endpoints for the project bound to your API key.
  - name: Imports and exports
    description: Imports and exports endpoints for the project bound to your API key.
  - name: Family Attributes
    description: Family Attributes endpoints for the project bound to your API key.
  - name: Product Categories
    description: Product Categories endpoints for the project bound to your API key.
  - name: Product Relations
    description: Product Relations endpoints for the project bound to your API key.
  - name: Assets
    description: Assets endpoints for the project bound to your API key.
  - name: Volume Discounts
    description: Volume Discounts endpoints for the project bound to your API key.
  - name: Product quality and history
    description: >-
      Product quality and history endpoints for the project bound to your API
      key.
  - name: Webhooks
    description: Webhooks endpoints for the project bound to your API key.
externalDocs:
  description: WISEPIM API reference and guides
  url: https://docs.wisepim.com/en/api-reference/introduction
paths:
  /api/public/v1/products/{product_id}/history:
    get:
      tags:
        - Product quality and history
      summary: List a product's change history
      description: >-
        The product's recorded changes, oldest first: who changed it, through

        which operation, and the before and after value of every changed field,

        attribute and category membership. Field changes cover the fields the

        product resource returns; `user` is the member's name, or "Team member"

        when they have none. History is kept for the plan's

        retention window (1 to 90 days); older changes are not returned. Pages

        hold 20 changes by default and at most 50. Requires
        `product-history:read`.
      operationId: public_v1_list_product_history
      parameters:
        - in: path
          name: product_id
          schema:
            title: Product Id
            type: integer
          required: true
        - in: query
          name: cursor
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Cursor
          required: false
        - in: query
          name: limit
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            title: Limit
          required: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductHistoryPage'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '413':
          description: Content Too Large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '422':
          description: Unprocessable Content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationErrorOut'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
      security:
        - ProjectApiKeyAuth: []
components:
  schemas:
    ProductHistoryPage:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ProductHistoryEntryOut'
          title: Data
          type: array
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
        has_more:
          title: Has More
          type: boolean
      required:
        - data
        - next_cursor
        - has_more
      title: ProductHistoryPage
      type: object
    ErrorOut:
      description: |-
        The shared error envelope every NinjaAPI instance renders.

        `code` is present for :class:`user_app.ninja_api.errors.ApiError`
        (`insufficient_scope`, `rate_limited`, `invalid_cursor`, …) so machine
        clients can branch without parsing `error`.
      properties:
        error:
          title: Error
          type: string
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
        request_id:
          title: Request Id
          type: string
      required:
        - error
        - request_id
      title: ErrorOut
      type: object
    ValidationErrorOut:
      description: 'HTTP 422: `detail` carries Ninja''s per-field validation errors.'
      properties:
        error:
          title: Error
          type: string
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
        request_id:
          title: Request Id
          type: string
        detail:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Detail
      required:
        - error
        - request_id
      title: ValidationErrorOut
      type: object
    ProductHistoryEntryOut:
      properties:
        id:
          title: Id
          type: integer
        seq:
          description: The product's revision number, increasing with every change.
          title: Seq
          type: integer
        changeset_id:
          description: Shared by every product one operation changed.
          title: Changeset Id
          type: integer
        kind:
          title: Kind
          type: string
        action:
          title: Action
          type: string
        label:
          title: Label
          type: string
        status:
          description: applied, or undone when the operation was reverted.
          title: Status
          type: string
        source:
          anyOf:
            - type: string
            - type: 'null'
          title: Source
        user:
          anyOf:
            - type: string
            - type: 'null'
          description: Who made the change; null for system and automation changes.
          title: User
        created_at:
          format: date-time
          title: Created At
          type: string
        changes:
          items:
            $ref: '#/components/schemas/HistoryChangeOut'
          title: Changes
          type: array
      required:
        - id
        - seq
        - changeset_id
        - kind
        - action
        - label
        - status
        - source
        - user
        - created_at
        - changes
      title: ProductHistoryEntryOut
      type: object
    HistoryChangeOut:
      properties:
        key:
          description: Field name, attr:<attribute id>, categories or volume_discounts.
          title: Key
          type: string
        label:
          title: Label
          type: string
        kind:
          description: field, attribute or category (a membership list).
          title: Kind
          type: string
        before:
          title: Before
        after:
          title: After
      required:
        - key
        - label
        - kind
        - before
        - after
      title: HistoryChangeOut
      type: object
  securitySchemes:
    ProjectApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: Project API key (wpk_...)
      description: >-
        Use a project API key from **Settings > API Access**. Send it as
        `Authorization: Bearer wpk_...`. See [authentication and
        scopes](/en/api-reference/authentication) for setup and permissions.
      x-scopes:
        project:read: Read the project's identity, locales and limits.
        project:write: Change the project's name, description, locales and currency.
        products:read: >-
          List and read products, including attribute values and category
          membership.
        products:write: Create and update products and their catalogue content.
        products:delete: Delete products from this project.
        product-history:read: >-
          Read the change history of the project's products, including previous
          values.
        categories:read: List the project's category tree.
        categories:write: Create and update the project's categories.
        categories:delete: Delete the project's categories.
        attributes:read: List the project's attribute definitions.
        attributes:write: Create and update the project's attribute definitions.
        attributes:delete: Delete the project's attribute definitions.
        attribute-groups:read: Read the project's attribute groups.
        attribute-groups:write: Create and update the project's attribute groups.
        attribute-groups:delete: Delete the project's attribute groups.
        product-families:read: Read the project's product families.
        product-families:write: Create and update the project's product families.
        product-families:delete: Delete the project's product families.
        family-attributes:read: Read the project's family attribute bindings.
        family-attributes:write: Create and update the project's family attribute bindings.
        family-attributes:delete: Delete the project's family attribute bindings.
        product-categories:read: Read the project's product category memberships.
        product-categories:write: Create and update the project's product category memberships.
        product-categories:delete: Delete the project's product category memberships.
        product-relations:read: >-
          Read relations between the project's products (cross-sells,
          accessories, bundle items).
        product-relations:write: Create and update relations between the project's products.
        product-relations:delete: Delete relations between the project's products.
        assets:read: >-
          Read the project's media library, image imports and the images
          attached to products.
        assets:write: >-
          Upload and import media, edit alt text, and attach, order and choose
          product images.
        assets:delete: Delete media from the project's library.
        volume-discounts:read: Read the project's volume discounts, their tiers and linked products.
        volume-discounts:write: >-
          Create and update the project's volume discounts, their tiers and
          linked products.
        volume-discounts:delete: Delete the project's volume discounts.
        value-code-sets:read: Read the project's controlled vocabularies.
        value-code-sets:write: Create and update the project's controlled vocabularies.
        value-code-sets:delete: Delete the project's controlled vocabularies.
        code-set-values:read: Read values in the project's controlled vocabularies.
        code-set-values:write: Create and update values in the project's controlled vocabularies.
        code-set-values:delete: Delete values in the project's controlled vocabularies.
        uom-code-sets:read: Read the project's unit-of-measure sets.
        uom-code-sets:write: Create and update the project's unit-of-measure sets.
        uom-code-sets:delete: Delete the project's unit-of-measure sets.
        uom-values:read: Read units in the project's unit-of-measure sets.
        uom-values:write: Create and update units in the project's unit-of-measure sets.
        uom-values:delete: Delete units in the project's unit-of-measure sets.
        prompts:read: Read prompts visible to the key issuer in this project.
        prompts:write: >-
          Create prompts and update the key issuer's own prompts in this
          project.
        prompts:delete: Delete the key issuer's own prompts in this project.
        knowledge-libraries:read: Read this project's knowledge library.
        knowledge-libraries:write: Create and update this project's knowledge library.
        knowledge-libraries:delete: Delete this project's knowledge library.
        keywords:read: Read the project's keywords.
        keywords:write: Create and update the project's keywords.
        keywords:delete: Delete the project's keywords.
        dictionary-entries:read: Read the project's translation dictionary entries.
        dictionary-entries:write: Create and update the project's translation dictionary entries.
        dictionary-entries:delete: Delete the project's translation dictionary entries.
        import-templates:read: Read the project's reusable import templates.
        import-templates:write: Create and update the project's reusable import templates.
        import-templates:delete: Delete the project's reusable import templates.
        export-templates:read: Read the project's reusable export templates.
        export-templates:write: Create and update the project's reusable export templates.
        export-templates:delete: Delete the project's reusable export templates.
        enrichment:execute: >-
          Start product enrichment using this project's native pipelines and
          credit limits.
        translations:execute: >-
          Start product translation using this project's native pipelines and
          credit limits.
        bulk-actions:execute: Start bulk actions against this project's products.
        exports:execute: >-
          Start product file exports with this project's export templates and
          download the result.
        imports:execute: >-
          Start CSV and Excel product imports with this project's import
          templates.
        jobs:read: Read this project's background job status and progress.
        jobs:cancel: Request cooperative cancellation of this project's background jobs.
        webhooks:read: Read this project's webhook subscriptions and their delivery log.
        webhooks:write: >-
          Create and update this project's webhook subscriptions and rotate
          their signing secrets.
        webhooks:delete: Delete this project's webhook subscriptions.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.