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

> For a subscription that delivers to your bucket: each version Ploti
wrote there, when, and whether it succeeded.




## OpenAPI

````yaml /platforms/openapi.yaml get /v1/subscriptions/{subscriptionId}/deliveries
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}/deliveries:
    get:
      tags:
        - Subscriptions
      summary: List deliveries
      description: |
        For a subscription that delivers to your bucket: each version Ploti
        wrote there, when, and whether it succeeded.
      operationId: listDeliveries
      parameters:
        - $ref: '#/components/parameters/subscriptionId'
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/cursor'
      responses:
        '200':
          description: A page of deliveries.
          content:
            application/json:
              schema:
                type: object
                required:
                  - deliveries
                  - nextCursor
                properties:
                  deliveries:
                    type: array
                    items:
                      $ref: '#/components/schemas/Delivery'
                  nextCursor:
                    $ref: '#/components/schemas/NextCursor'
components:
  parameters:
    subscriptionId:
      name: subscriptionId
      in: path
      required: true
      schema:
        type: string
      example: sub_8f3k2m
    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:
    Delivery:
      type: object
      required:
        - datasetId
        - version
        - status
        - startedAt
      properties:
        datasetId:
          type: string
        version:
          type: integer
        kind:
          type: string
          enum:
            - snapshot
            - changes
        status:
          type: string
          enum:
            - pending
            - delivered
            - failed
        path:
          type: string
          description: Where in your bucket the files were written.
        startedAt:
          type: string
          format: date-time
        finishedAt:
          type:
            - string
            - 'null'
          format: date-time
        error:
          type:
            - string
            - 'null'
    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.