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



## OpenAPI

````yaml /platforms/openapi.yaml get /v1/subscriptions/{subscriptionId}
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}:
    get:
      tags:
        - Subscriptions
      summary: Get a subscription
      operationId: getSubscription
      parameters:
        - $ref: '#/components/parameters/subscriptionId'
      responses:
        '200':
          description: The subscription.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Subscription'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    subscriptionId:
      name: subscriptionId
      in: path
      required: true
      schema:
        type: string
      example: sub_8f3k2m
  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
    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.
    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.