> ## 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.

# Get a subscription's manifest

> Every dataset the subscription delivers with its current version,
schema version and file links, plus the event cursor this manifest
is current as of. Load these snapshots, then read events after
`eventCursor`, and nothing is missed.




## OpenAPI

````yaml /platforms/openapi.yaml get /v1/subscriptions/{subscriptionId}/manifest
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/subscriptions/{subscriptionId}/manifest:
    get:
      tags:
        - Subscriptions
      summary: Get a subscription's manifest
      description: |
        Every dataset the subscription delivers with its current version,
        schema version and file links, plus the event cursor this manifest
        is current as of. Load these snapshots, then read events after
        `eventCursor`, and nothing is missed.
      operationId: getSubscriptionManifest
      parameters:
        - $ref: '#/components/parameters/subscriptionId'
        - name: format
          in: query
          schema:
            type: string
            enum:
              - geoparquet
              - csv
            default: geoparquet
      responses:
        '200':
          description: The manifest.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Manifest'
components:
  parameters:
    subscriptionId:
      name: subscriptionId
      in: path
      required: true
      schema:
        type: string
      example: sub_8f3k2m
  schemas:
    Manifest:
      type: object
      required:
        - subscriptionId
        - generatedAt
        - eventCursor
        - datasets
      properties:
        subscriptionId:
          type: string
        generatedAt:
          type: string
          format: date-time
        eventCursor:
          type: string
          description: Read events after this id once these snapshots are loaded.
        datasets:
          type: array
          items:
            type: object
            required:
              - datasetId
              - version
              - schemaVersion
              - files
            properties:
              datasetId:
                type: string
              title:
                type: string
              place:
                type: string
              topic:
                type: string
              version:
                type: integer
              schemaVersion:
                type: string
              files:
                type: object
                properties:
                  snapshot:
                    type: array
                    items:
                      $ref: '#/components/schemas/File'
                  schema:
                    $ref: '#/components/schemas/File'
                  expiresAt:
                    type: string
                    format: date-time
    File:
      type: object
      required:
        - url
        - format
        - rows
        - bytes
        - sha256
      properties:
        url:
          type: string
          format: uri
        format:
          type: string
          enum:
            - geoparquet
            - csv
            - json
        rows:
          type: integer
        bytes:
          type: integer
        sha256:
          type: string
  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.