For the complete documentation index, see llms.txt. This page is also available as Markdown.

Data Standards

Soda Cloud API Data Standard Endpoints

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

Authorizations
AuthorizationstringRequired
Query parameters
pageinteger · int32Optional
searchstringOptional
sizeinteger · int32Optional
sortobject · enumOptionalPossible values:
statusobject · enumOptionalPossible values:
Responses
200

Successful response

application/json
firstbooleanRequired
lastbooleanRequired
numberinteger · int32Required
sizeinteger · int32Required
totalElementsinteger · int32Required
totalPagesinteger · int32Required
get/api/v1/dataStandards

Create a data standard

post
/api/v1/dataStandards

This endpoint allows you to create a new data standard from YAML contents, a structured scope, status, owners and an optional schedule.

The contents field must contain valid data standard YAML. If the YAML is malformed, the request is rejected with a 400 error.

Authorization

Only users with Manage data standards permission can create data standards.

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.

Authorization

Users must have global role permission MANAGE_DATA_STANDARDS to execute this call.

Tags

Data Standards

Rate limiting

100 requests/60 seconds

Authorizations
AuthorizationstringRequired
Body
contentsstringRequired
descriptionstringOptional
labelstringOptional
namestringRequired
statusobject · enumRequiredPossible values:
Responses
200

Successful response

application/json
post/api/v1/dataStandards

Execute data standards for a dataset

post
/api/v1/dataStandards/actions/execute

This endpoint triggers a scan that runs the active data standards linked to the specified dataset.

The response, when successful, is 201 and contains the header X-Soda-Scan-Id and a Location header which identify the triggered scan. Use the value of X-Soda-Scan-Id in the scanId parameter of the Get scan status, Get scan logs, and Cancel a scan endpoints.

Authorization

Only users with Manage data standards permission can execute data standards.

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.

Authorization

Users must have global role permission MANAGE_DATA_STANDARDS to execute this call.

Tags

Data Standards

Rate limiting

10 requests/60 seconds

Authorizations
AuthorizationstringRequired
Body
datasetIdstringRequired
Responses
201

Created

application/json
dataStandardIdsstring[]Optional
scanIdstringOptional
post/api/v1/dataStandards/actions/execute

Preview the datasets matching a data standard scope

post
/api/v1/dataStandards/actions/previewScope

This endpoint evaluates a candidate scope and returns the datasets that would match it, without creating or modifying any data standard.

The scope uses the same structured rule grammar as the create-data-standard endpoint. An omitted or empty scope matches all datasets, mirroring how a data standard without a scope applies to every dataset. Results are paged with page (0-based, default 0) and size (between 1 and 1000, default 10).

Authorization

Only users with Manage data standards permission can preview a data standard scope.

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.

Authorization

Users must have global role permission MANAGE_DATA_STANDARDS to execute this call.

Tags

Data Standards

Rate limiting

100 requests/60 seconds

Authorizations
AuthorizationstringRequired
Body
pageinteger · int32Optional
sizeinteger · int32Optional
Responses
200

Successful response

application/json
firstbooleanRequired
lastbooleanRequired
numberinteger · int32Required
sizeinteger · int32Required
totalElementsinteger · int32Required
totalPagesinteger · int32Required
post/api/v1/dataStandards/actions/previewScope

Test a data standard against a dataset

post
/api/v1/dataStandards/actions/test

This endpoint runs the checks of an unsaved data standard against one dataset's live data, without creating or modifying any data standard. The tested standard does not appear in your data standards and no checks or check results are persisted; the outcome is only visible on the triggered scan.

The contents field must contain valid data standard YAML. If the YAML is malformed, the request is rejected with a 400 error.

The response, when successful, is 201 and contains the header X-Soda-Scan-Id and a Location header which identify the triggered scan. Use the value of X-Soda-Scan-Id in the scanId parameter of the Get scan status, Get scan logs, and Cancel a scan endpoints.

Authorization

Only users with Manage data standards permission who can view the dataset's datasource can test a data standard.

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.

Authorization

Users must have global role permission MANAGE_DATA_STANDARDS to execute this call.

Tags

Data Standards

Rate limiting

10 requests/60 seconds

Authorizations
AuthorizationstringRequired
Body
contentsstringRequired
datasetIdstringRequired
Responses
201

Created

application/json
scanIdstringOptional
post/api/v1/dataStandards/actions/test

Data standards activity

get
/api/v1/dataStandards/activity

This endpoint returns an organization-wide rollup of data standards activity, including counts of active and total standards, matched datasets, and check results.

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

Authorizations
AuthorizationstringRequired
Responses
200

Successful response

application/json
get/api/v1/dataStandards/activity

Get a data standard

get
/api/v1/dataStandards/{dataStandardId}

This endpoint allows you to retrieve a specific data standard, including its YAML contents and scope.

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

1000 requests/60 seconds

Authorizations
AuthorizationstringRequired
Path parameters
dataStandardIdstringRequired
Responses
200

Successful response

application/json
get/api/v1/dataStandards/{dataStandardId}

Update a data standard

post
/api/v1/dataStandards/{dataStandardId}

This endpoint allows you to replace an existing data standard's YAML contents, scope, status, owners and schedule.

The contents field must contain valid data standard YAML. If the YAML is malformed, the request is rejected with a 400 error.

Authorization

Only users with Manage data standards permission can update data standards.

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.

Authorization

Users must have global role permission MANAGE_DATA_STANDARDS to execute this call.

Tags

Data Standards

Rate limiting

100 requests/60 seconds

Authorizations
AuthorizationstringRequired
Path parameters
dataStandardIdstringRequired
Body
contentsstringRequired
descriptionstringOptional
labelstringOptional
namestringRequired
statusobject · enumRequiredPossible values:
Responses
200

Successful response

application/json
post/api/v1/dataStandards/{dataStandardId}

Delete a data standard

delete
/api/v1/dataStandards/{dataStandardId}

Schedules a data standard for deletion. Deletion is processed asynchronously: the standard and its dataset associations, owners and YAML file are removed in the background.

Authorization

Only users with Manage data standards permission can delete data standards.

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.

Authorization

Users must have global role permission MANAGE_DATA_STANDARDS to execute this call.

Tags

Data Standards

Rate limiting

100 requests/60 seconds

Authorizations
AuthorizationstringRequired
Path parameters
dataStandardIdstringRequired
Responses
200

Successful response

application/json
messagestringRequired
delete/api/v1/dataStandards/{dataStandardId}

Evaluate a data standard's scope

post
/api/v1/dataStandards/{dataStandardId}/actions/evaluateScope

This endpoint re-evaluates a data standard's scope and returns the ids of the datasets that currently match it.

Authorization

Only users with Manage data standards permission can evaluate a data standard's scope.

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.

Authorization

Users must have global role permission MANAGE_DATA_STANDARDS to execute this call.

Tags

Data Standards

Rate limiting

100 requests/60 seconds

Authorizations
AuthorizationstringRequired
Path parameters
dataStandardIdstringRequired
Responses
200

Successful response

application/json
dataStandardIdstringOptional
datasetIdsstring[]Optional
post/api/v1/dataStandards/{dataStandardId}/actions/evaluateScope

Update a data standard's status

post
/api/v1/dataStandards/{dataStandardId}/actions/status

This endpoint transitions a data standard to a new status without modifying its contents, scope, owners or schedule.

Allowed transitions are validated; an invalid transition is rejected with a 400 error.

Authorization

Only users with Manage data standards permission can update a data standard's status.

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.

Authorization

Users must have global role permission MANAGE_DATA_STANDARDS to execute this call.

Tags

Data Standards

Rate limiting

100 requests/60 seconds

Authorizations
AuthorizationstringRequired
Path parameters
dataStandardIdstringRequired
Body
statusobject · enumRequiredPossible values:
Responses
200

Successful response

application/json
post/api/v1/dataStandards/{dataStandardId}/actions/status

List data standard checks

get
/api/v1/dataStandards/{dataStandardId}/checks

This endpoint allows you to list the aggregated checks of a specific data standard.

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.

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

Authorizations
AuthorizationstringRequired
Path parameters
dataStandardIdstringRequired
Query parameters
pageinteger · int32Optional
sizeinteger · int32Optional
Responses
200

Successful response

application/json
firstbooleanRequired
lastbooleanRequired
numberinteger · int32Required
sizeinteger · int32Required
totalElementsinteger · int32Required
totalPagesinteger · int32Required
get/api/v1/dataStandards/{dataStandardId}/checks

List data standard datasets

get
/api/v1/dataStandards/{dataStandardId}/datasets

This endpoint allows you to list the datasets matched by a specific data standard.

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.

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

Authorizations
AuthorizationstringRequired
Path parameters
dataStandardIdstringRequired
Query parameters
pageinteger · int32Optional
sizeinteger · int32Optional
Responses
200

Successful response

application/json
firstbooleanRequired
lastbooleanRequired
numberinteger · int32Required
sizeinteger · int32Required
totalElementsinteger · int32Required
totalPagesinteger · int32Required
get/api/v1/dataStandards/{dataStandardId}/datasets

Last updated

Was this helpful?