> ## 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 datasets > Datasets in the workspace's coverage that can be delivered. Filter by place, topic or subscription, or by `updatedSince` to find what has a new version. ## OpenAPI ````yaml /platforms/openapi.yaml get /v1/datasets 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: get: tags: - Datasets summary: List datasets description: | Datasets in the workspace's coverage that can be delivered. Filter by place, topic or subscription, or by `updatedSince` to find what has a new version. operationId: listDatasets parameters: - name: place in: query description: A place id, e.g. `us-fl-12095`. schema: type: string - name: topic in: query schema: type: string - name: subscription in: query description: Only datasets a subscription delivers. schema: type: string - name: updatedSince in: query description: Only datasets with a version published after this time. schema: type: string format: date-time - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/cursor' responses: '200': description: A page of datasets. content: application/json: schema: type: object required: - datasets - nextCursor properties: datasets: type: array items: $ref: '#/components/schemas/Dataset' nextCursor: $ref: '#/components/schemas/NextCursor' '401': $ref: '#/components/responses/Unauthorized' 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: Dataset: type: object required: - id - title - place - topic - source - current - keyColumns - refresh properties: id: type: string examples: - ds_orange_fl_building_permits title: type: string examples: - Building permits description: type: string place: $ref: '#/components/schemas/Place' topic: type: string examples: - permits source: $ref: '#/components/schemas/Source' geometry: type: - object - 'null' description: Null for a table without geometry. properties: type: type: string enum: - Point - LineString - Polygon - MultiPoint - MultiLineString - MultiPolygon srid: type: integer const: 4326 keyColumns: type: array items: type: string description: | The columns that identify a record across versions. Empty when the source has no stable key; records are then matched by content. examples: - - permit_number current: type: object required: - version - schemaVersion - publishedAt - rowCount properties: version: type: integer examples: - 42 schemaVersion: type: string examples: - '2.1' publishedAt: type: string format: date-time sourceCheckedAt: type: string format: date-time description: When Ploti last checked the source, changed or not. rowCount: type: integer refresh: type: object properties: cadence: type: string enum: - daily - weekly - monthly - quarterly - annual nextCheckAt: type: string format: date-time NextCursor: type: - string - 'null' description: Pass as `cursor` for the next page. Null on the last page. Place: type: object required: - id - name - state - kind properties: id: type: string description: '`us--`.' examples: - us-fl-12095 name: type: string examples: - Orange County state: type: string examples: - FL kind: type: string enum: - county datasetCounts: type: object description: Datasets by topic id. additionalProperties: type: integer examples: - permits: 6 zoning: 3 parcels: 1 Source: type: object description: The public body that publishes the record and where Ploti reads it. required: - publisher - url properties: publisher: type: string examples: - Orange County Division of Building Safety url: type: string format: uri description: Where the public record is published. license: type: - string - 'null' description: The terms the publisher states, when it states any. 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: Unauthorized: description: Missing or invalid API key, or a key without the `feeds` scope. 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.