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

# List item versions

> Returns the version-snapshot history for one item, newest first. Each snapshot carries the version number, the timestamp of the update that produced it, the full properties at that version, and the credential that wrote it.

Snapshots are thinned on a rolling schedule — every snapshot in the recent window, one per calendar day in the daily window, one per ISO week in the weekly window, dropped beyond. The most recent snapshot is never thinned. To restore from a version, fetch its properties and re-send them through `PATCH /items/{id}` — the restore becomes a new forward version. See [Versions](/concepts/versions).



## OpenAPI

````yaml /openapi.json get /items/{id}/versions
openapi: 3.1.0
info:
  title: Marfa API
  version: 4.2.0
  description: Typed data layer for structured personal data
servers: []
security: []
paths:
  /items/{id}/versions:
    get:
      tags:
        - Items
      summary: List item versions
      description: >-
        Returns the version-snapshot history for one item, newest first. Each
        snapshot carries the version number, the timestamp of the update that
        produced it, the full properties at that version, and the credential
        that wrote it.


        Snapshots are thinned on a rolling schedule — every snapshot in the
        recent window, one per calendar day in the daily window, one per ISO
        week in the weekly window, dropped beyond. The most recent snapshot is
        never thinned. To restore from a version, fetch its properties and
        re-send them through `PATCH /items/{id}` — the restore becomes a new
        forward version. See [Versions](/concepts/versions).
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
      responses:
        '200':
          description: Version history
          content:
            application/json:
              schema:
                type: object
                properties:
                  versions:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        item_id:
                          type: string
                        version:
                          type: number
                        properties:
                          type: object
                          additionalProperties:
                            nullable: true
                        created_at:
                          type: string
                        device:
                          type: string
                      required:
                        - id
                        - item_id
                        - version
                        - properties
                        - created_at
                required:
                  - versions
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - unauthorized
                      message:
                        type: string
                      details:
                        type: object
                        additionalProperties:
                          nullable: true
                    required:
                      - code
                      - message
                required:
                  - error
        '404':
          description: Item not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - item_not_found
                      message:
                        type: string
                      details:
                        type: object
                        additionalProperties:
                          nullable: true
                    required:
                      - code
                      - message
                required:
                  - error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key or OAuth Token
      description: Pass an API key (marfa_k1_...) or OAuth access token (marfa_at_...)

````