---
title: "List all data sets"
method: GET
path: "/data-sets"
tags: ["Data Sets"]
---

# List all data sets

`GET /data-sets`

Returns a list of data sets.
The results are returned 20 at a time, sorted in order of creation date.
You must use the links section to get the next 20 results.

## Query parameters

- `_` string

## Response `200`

- ListDataSetsResponse
  - `dataSets` object[]
    - `id` string, required — The resource's ID.
    - `audit` object, required — Creation and last-modification metadata.
      - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
      - `createdBy` object, required — User who created the resource.
        - `id` string, required — The resource's ID.
        - `email` string, required — The user's email address (also their login identifier).
        - `username` string, required — The user's display name (e.g. `Jane Doe`).
      - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
      - `updatedBy` object, required — User who last modified the resource.
        - `id` string, required — The resource's ID.
        - `email` string, required — The user's email address (also their login identifier).
        - `username` string, required — The user's display name (e.g. `Jane Doe`).
    - `deletedDate` string, date-time
    - `deletedBy` object
      - `id` string, required — The resource's ID.
      - `email` string, required — The user's email address (also their login identifier).
      - `username` string, required — The user's display name (e.g. `Jane Doe`).
    - `organizationId` string, required — The ID of the organization this resource belongs to.
    - `name` string, required — Display name.
    - `fields` object[] — Form field definitions or column definitions, depending on context.
      - `id` string, required — The resource's ID.
      - `audit` object, required — Creation and last-modification metadata.
        - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
        - `createdBy` object, required — User who created the resource.
          - `id` string, required — The resource's ID.
          - `email` string, required — The user's email address (also their login identifier).
          - `username` string, required — The user's display name (e.g. `Jane Doe`).
        - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
        - `updatedBy` object, required — User who last modified the resource.
          - `id` string, required — The resource's ID.
          - `email` string, required — The user's email address (also their login identifier).
          - `username` string, required — The user's display name (e.g. `Jane Doe`).
      - `name` string, required — Display name.
      - `fieldType` 'Text' | 'DateTime' | 'Number', required — Data type of the column. - `Text` — free-form string. - `Number` — numeric value. - `DateTime` — ISO-8601 date-time.
  - `links` object[] — Navigable HATEOAS links to related resources. Each entry has a `name` (RFC-5988 relation), an `href` URL, and a `type` (`Api` or `App`).
    - `name` string, required — Standard link relation name (RFC 5988) indicating this link's role. Common values include `self`, `edit`, `related`, `previous`, `next`.
    - `href` string, required — URL of the linked resource.
    - `rel` 'Approval Task' | 'Approvals' | 'Assignees' | 'Comment' | 'Data Set Records' | 'Data Sets' | 'Form Field Values' | 'Subject Task' | 'Task' | 'Tasks' | 'Users' | 'Webhook' | 'Workflow' | 'Workflow Run' — Optional. The kind of resource this link points to (e.g. `Workflow`, `Task`, `Comment`).
    - `type` 'Api' | 'App', required — Whether this link targets an API endpoint or a Process Street app URL. `Api` — a callable API endpoint you can fetch directly. `App` — a browser-facing URL in the Process Street UI.

## Other responses

- `default`

---

[API](https://skmtc.net/process/apis/process-street-public-api.md) · [All operations](https://skmtc.net/process/apis/process-street-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/process/process-street-public-api/revisions/6199a9464227/schema)