> ## 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 dataset's versions

> Published versions, newest first.



## OpenAPI

````yaml /platforms/openapi.yaml get /v1/datasets/{datasetId}/versions
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:
    get:
      tags:
        - Versions
      summary: List a dataset's versions
      description: Published versions, newest first.
      operationId: listDatasetVersions
      parameters:
        - $ref: '#/components/parameters/datasetId'
        - name: after
          in: query
          description: Only versions newer than this one.
          schema:
            type: integer
            minimum: 0
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/cursor'
      responses:
        '200':
          description: A page of versions.
          content:
            application/json:
              schema:
                type: object
                required:
                  - versions
                  - nextCursor
                properties:
                  versions:
                    type: array
                    items:
                      $ref: '#/components/schemas/Version'
                  nextCursor:
                    $ref: '#/components/schemas/NextCursor'
components:
  parameters:
    datasetId:
      name: datasetId
      in: path
      required: true
      schema:
        type: string
      example: ds_orange_fl_building_permits
    limit:
      name: limit
      in: query
      schema:
        type: integer
        minimum: 1
        maximum: 200
        default: 50
    cursor:
      name: cursor
      in: query
      description: The `nextCursor` of the previous page.
      schema:
        type: string
  schemas:
    Version:
      type: object
      required:
        - datasetId
        - version
        - schemaVersion
        - publishedAt
        - rowCount
        - counts
      properties:
        datasetId:
          type: string
        version:
          type: integer
        previousVersion:
          type:
            - integer
            - 'null'
        schemaVersion:
          type: string
        publishedAt:
          type: string
          format: date-time
        sourceFetchedAt:
          type: string
          format: date-time
          description: When Ploti read this version from the source.
        rowCount:
          type: integer
        counts:
          type: object
          required:
            - added
            - changed
            - removed
          properties:
            added:
              type: integer
            changed:
              type: integer
            removed:
              type: integer
        resyncRequired:
          type: boolean
          description: |
            True when this version's changes cannot be applied to the version
            before it (the key columns changed). Load its snapshot instead.
    NextCursor:
      type:
        - string
        - 'null'
      description: Pass as `cursor` for the next page. Null on the last page.
  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.