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

# List a version's changes

> The records a version added, changed or removed relative to the
version before it, as JSON pages. For large versions, read the
version's `changes` files instead.




## OpenAPI

````yaml /platforms/openapi.yaml get /v1/datasets/{datasetId}/versions/{version}/changes
openapi: 3.1.0
info:
  title: Ploti Data Feeds API
  version: 1.0.0
  description: |
    Early access: contact support@ploti.ai to set up a subscription.

    Public records from the places your workspace covers, delivered to your
    own systems. Subscribe to counties, load each dataset's snapshot once,
    then apply each new version's changes as Ploti publishes them.

    Every call acts as the workspace member who holds the API key. Lists that
    page take `limit` and `cursor` and return `nextCursor`, null on the last
    page. Fields are camelCase. A refusal is
    `{ "error": { "code", "message", "links" } }`.
servers:
  - url: https://api.ploti.ai
security:
  - bearerAuth: []
tags:
  - name: Places
    description: The counties a workspace can subscribe to.
  - name: Datasets
    description: What each dataset holds, where it comes from and how it is shaped.
  - name: Versions
    description: Each published version of a dataset, its files and its changes.
  - name: Subscriptions
    description: The places, topics and datasets you receive, and where they are delivered.
  - name: Events
    description: An ordered, replayable log of what changed in a subscription.
paths:
  /v1/datasets/{datasetId}/versions/{version}/changes:
    get:
      tags:
        - Versions
      summary: List a version's changes
      description: |
        The records a version added, changed or removed relative to the
        version before it, as JSON pages. For large versions, read the
        version's `changes` files instead.
      operationId: listVersionChanges
      parameters:
        - $ref: '#/components/parameters/datasetId'
        - $ref: '#/components/parameters/version'
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 500
        - $ref: '#/components/parameters/cursor'
      responses:
        '200':
          description: A page of changes.
          content:
            application/json:
              schema:
                type: object
                required:
                  - datasetId
                  - version
                  - changes
                  - nextCursor
                properties:
                  datasetId:
                    type: string
                  version:
                    type: integer
                  changes:
                    type: array
                    items:
                      $ref: '#/components/schemas/Change'
                  nextCursor:
                    $ref: '#/components/schemas/NextCursor'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    datasetId:
      name: datasetId
      in: path
      required: true
      schema:
        type: string
      example: ds_orange_fl_building_permits
    version:
      name: version
      in: path
      required: true
      schema:
        type: integer
        minimum: 1
    cursor:
      name: cursor
      in: query
      description: The `nextCursor` of the previous page.
      schema:
        type: string
  schemas:
    Change:
      type: object
      required:
        - op
        - recordId
      properties:
        op:
          type: string
          enum:
            - upsert
            - delete
        recordId:
          type: string
          description: Stable across versions while the key columns are unchanged.
        kind:
          type: string
          enum:
            - added
            - changed
          description: For an upsert, whether the record is new or changed.
        record:
          type:
            - object
            - 'null'
          description: The record as of this version. Null for a delete.
          additionalProperties: true
    NextCursor:
      type:
        - string
        - 'null'
      description: Pass as `cursor` for the next page. Null on the last page.
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              examples:
                - not_found
                - outside_coverage
                - not_distributable
                - cursor_expired
            message:
              type: string
            links:
              type: object
              additionalProperties:
                type: string
                format: uri
  responses:
    NotFound:
      description: Not found, or not in the workspace's coverage.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: An API key from Settings, API keys, with the `feeds` scope.

````

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