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



## OpenAPI

````yaml /platforms/openapi.yaml get /v1/subscriptions
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:
    get:
      tags:
        - Subscriptions
      summary: List subscriptions
      operationId: listSubscriptions
      parameters:
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/cursor'
      responses:
        '200':
          description: A page of subscriptions.
          content:
            application/json:
              schema:
                type: object
                required:
                  - subscriptions
                  - nextCursor
                properties:
                  subscriptions:
                    type: array
                    items:
                      $ref: '#/components/schemas/Subscription'
                  nextCursor:
                    $ref: '#/components/schemas/NextCursor'
components:
  parameters:
    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:
    Subscription:
      type: object
      required:
        - id
        - name
        - places
        - topics
        - datasetIds
        - delivery
        - datasetCount
        - createdAt
      properties:
        id:
          type: string
        name:
          type: string
        places:
          type: array
          items:
            type: string
        topics:
          type: array
          items:
            type: string
        datasetIds:
          type: array
          items:
            type: string
        delivery:
          $ref: '#/components/schemas/DeliveryTarget'
        format:
          type: string
          enum:
            - geoparquet
            - csv
        datasetCount:
          type: integer
        lastEventId:
          type:
            - string
            - 'null'
        createdAt:
          type: string
          format: date-time
    NextCursor:
      type:
        - string
        - 'null'
      description: Pass as `cursor` for the next page. Null on the last page.
    DeliveryTarget:
      description: |
        Where a subscription's files are delivered. More destination types
        are added as customers need them; each receives the same files.
      oneOf:
        - type: object
          title: Pull
          required:
            - type
          properties:
            type:
              const: pull
        - type: object
          title: Amazon S3
          required:
            - type
            - bucket
            - roleArn
          properties:
            type:
              const: s3
            bucket:
              type: string
            prefix:
              type: string
            region:
              type: string
            roleArn:
              type: string
              description: A role in your account that Ploti assumes to write.
        - type: object
          title: Google Cloud Storage
          required:
            - type
            - bucket
            - serviceAccount
          properties:
            type:
              const: gcs
            bucket:
              type: string
            prefix:
              type: string
            serviceAccount:
              type: string
              description: Grant Ploti's service account write access to the bucket.
  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.