---
title: "List data standards"
method: GET
path: "/api/v1/dataStandards"
tags: ["Data Standards"]
---

# List data standards

`GET /api/v1/dataStandards`

This endpoint allows you to list the data standards in your organization.

This GET is a paginated API that uses the following parameters to request specific details:

- `size`: Supply an integer value between 1 and 1000, inclusive. The default value is 10.

- `page`: Supply an integer value. The default value is 0.

- `search`: Optionally, use this parameter to perform a fuzzy search on the data standard name and label.

- `status`: Optionally, use this parameter to list only data standards with a given status (`draft`, `active`, `paused`, or `invalid`).

- `sort`: Optionally, sort the results by `name` (default) or `label`.

## Authentication

User authentication required: `true`

This endpoint accepts authentication via API keys in the `Basic` authentication header, or a pre-authenticated token in HTTP cookie `token`. Cookie sessions extend automatically on each request.

## Tags

`Data Standards`

## Rate limiting

60 requests/60 seconds

## Query parameters

- `page` integer
- `search` string
- `size` integer
- `sort` 'name' | 'label'
- `status` 'draft' | 'active' | 'paused' | 'invalid'

## Response `200`

Successful response

- PublicApiListDataStandardsResponse
  - `content` DataStandardContentDTO[], required
    - `checkResults` DataStandardCheckResultsDTO
      - `failingCount` integer
      - `notEvaluatedCount` integer
      - `passingCount` integer
      - `warningCount` integer
    - `cloudUrl` string
    - `compliance` number
    - `contents` string
    - `created` string, date-time
    - `datasetCount` integer
    - `description` string
    - `id` string, required
    - `label` string
    - `lastScanTime` string, date-time
    - `lastUpdated` string, date-time
    - `name` string
    - `owners` DatasetOwnerDTO[]
      - `type` 'user' | 'userGroup', required
      - `user` UserContentDTO
        - `email` string, required
        - `firstName` string
        - `fullName` string
        - `lastName` string
        - `userId` string, required
      - `userGroup` UserGroupContentBasicDTO
        - `name` string, required
        - `userGroupId` string, required
    - `schedule` DataStandardScheduleDTO
      - `enabled` boolean
    - `scope` DataStandardScopeDTO
      - `rules` DataStandardScopeRuleDTO[]
        - `datasourceId` string
        - `name` string
        - `schema` string
    - `status` 'draft' | 'active' | 'paused' | 'invalid'
  - `first` boolean, required
  - `last` boolean, required
  - `number` integer, required
  - `size` integer, required
  - `totalElements` integer, required
  - `totalPages` integer, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.dev/soda/apis/soda-cloud-api-v4.md) · [All operations](https://skmtc.dev/soda/apis/soda-cloud-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/soda/soda-cloud-api-v4/revisions/ce87192b6b72/schema)