Be first to try Soda's new AI-powered metrics observability, and collaborative data contracts.
Request a Demo!
LogoLogo
Soda v3
Soda v3
  • Soda v3 documentation
  • Get started
    • Get started roadmap
    • Choose a flavor of Soda
    • Install Soda Library
    • Set up a Soda-hosted agent
    • Deploy a Soda Agent
    • Deploy a self-hosted Soda Agent from Soda's private container registry
    • Soda Agent extras
    • Invoke Soda Library
    • Upgrade, redeploy, or uninstall Soda
  • Use case guides
    • Test data quality in an Airflow data pipeline
    • Test data quality in an Azure Data Factory pipeline
    • Test data quality in a Dagster pipeline
    • Test data quality in a Databricks pipeline
    • Test data quality before migration
    • Test data quality during CI/CD development
    • Self-serve Soda
    • Automate anomaly detection
    • Build a Sigma dashboard
    • Build a Grafana dashboard
    • Add Soda to a Databricks notebook
    • Integrate an External Secrets Manager with a Soda Agent
    • Generate API keys
    • Manage sensitive data
    • Reroute failed row samples
    • Double-onboard a data source
  • Write SodaCL checks
    • SodaCL tutorial
    • Write checks with Ask AI
    • Adopt check suggestions
    • Add automated monitoring checks
    • Profile data with Soda
    • Sample data with Soda
    • Compare data using SodaCL
    • Custom check examples
  • Run a scan and view results
    • Manage failed row samples
    • Manage scheduled scans
    • Configure orchestrated scans
    • Soda Library Python API reference
  • Organize results, set alerts, investigate issues
    • Activate anomaly dashboards
    • Add check attributes
    • Set notification rules
    • Organize datasets
    • Create and track incidents
    • Manage global roles, user groups, and settings
    • Manage dataset roles
  • Integrate Soda
    • Integrate Soda with Alation
    • Integrate Soda with Atlan
    • Integrate Soda with dbt
    • Integrate Soda with a GitHub Workflow
    • Integrate Soda with Jira
    • Integrate Soda with Microsoft Teams
    • Integrate Soda with Purview
    • Integrate Soda with ServiceNow
    • Integrate Soda with Slack
    • Integrate Soda with SSO
    • Integrate Soda with webhooks
  • SodaCL reference
    • SodaCL metrics and checks
    • SodaCL optional check configurations
    • Anomaly detection checks (deprecated)
    • Anomaly score checks (deprecated)
    • Check template
    • Cross checks
    • Distribution checks
    • Failed rows checks
    • Filters and variables
    • For each
    • Freshness checks
    • Group by
    • Group evolution checks
    • Missing metrics
    • Numeric metrics
    • Reconciliation checks
    • Reference checks
    • Schema checks
    • User-defined checks
    • Validity metrics
    • Troubleshoot SodaCL
  • Data source reference
    • Connect Soda to Amazon Athena
    • Connect Soda to GCP BigQuery
    • Connect Soda to ClickHouse
    • Connect Soda to Dask and Pandas
    • Connect Soda to Databricks
    • Connect Soda to Denodo
    • Connect Soda to Dremio
    • Connect Soda to DuckDB
    • Connect Soda to Google CloudSQL
    • Connect Soda to IBM DB2
    • Connect Soda to a local file using Dask
    • Connect Soda to MotherDuck
    • Connect Soda to MS SQL Server
    • Connect Soda to Microsoft Fabric
    • Connect Soda to MySQL
    • Connect Soda to OracleDB
    • Connect Soda to PostgreSQL
    • Connect Soda to Presto
    • Connect Soda to Amazon Redshift
    • Connect Soda to Snowflake
    • Connect Soda to Apache Spark
    • Connect Soda to Azure Synapse
    • Connect Soda to Trino
    • Connect Soda to Vertica
    • Troubleshoot data source connections
  • Soda Cloud API v1
    • Authentication
    • Examples
    • Checks
    • Datasets
    • Incidents
    • Scans
    • Users
    • Utility
    • Models
    • GET checks into CSV files
  • Soda Cloud Reporting API v1
    • Authentication
    • Examples
    • Status
    • Authentication
    • Auditing
    • Coverage
    • Quality
    • Platform Impact
    • Models
    • Reporting API migration guide
  • Set up data contracts
    • Write a data contract
    • Verify a data contract
    • Data contract check reference
  • Learning resources
    • Glossary
    • Soda overview
    • How Soda works
    • Soda Agent basic concepts
    • Soda architecture
    • Active checks and datasets
    • Data security and privacy
    • Soda Library usage statistics
    • Support
    • Soda community code of conduct
    • Soda SQL and Soda Spark are now Soda Core
  • Soda Core
  • Release notes
    • Soda product release states
    • Release notes for Soda products
    • Release notes for Soda Library
    • Release notes for Soda Agent
    • Release notes for Soda Cloud
    • Release notes for Soda Cloud API
    • Release notes for Soda Cloud Reporting API
    • Release notes for Soda Core
Powered by GitBook
On this page
Export as PDF
  1. Soda Cloud Reporting API v1

Quality

PreviousCoverageNextPlatform Impact

Was this helpful?

CtrlK
  • POSTCheck results [Paginated]
  • POSTDataset health [Paginated]

Was this helpful?

Check results [Paginated]

post

This endpoint provides a list of checks along with each checks's historical evaluation results.

Usage

Use this endpoint to build reports that show the outcome of your checks over time. If you gathered high-level data from the /dataset_health and /dataset_coverage endpoints, you can use this endpoint to examine more granular data about checks that apply to each dataset.

You can provide multiple dataset_ids per request, and use the from_datetime parameter to optimize performance. Use the datasets endpoint to first get a list of available datasets along with their IDs, then issue separate queries one dataset at a time.

Keep the number of potentially parallel queries that you make to this endpoint small as they can face rate limitations or poor performance.

Returns

An object of type CheckResultsResult containing an array of CheckResultsData

Find details about the response objects in the Schemas section or by unfurling the response details.

Authorizations
Body
all ofOptionalDefault: {"page":1,"size":400}
Responses
200

Successful Response

application/json
202

Successful request but no data was returned

application/json
422

Validation Error

application/json
post
POST /v1//quality/check_results HTTP/1.1
Host: reporting.cloud.soda.io
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "page": 1,
  "size": 400,
  "dataset_ids": [
    "text"
  ],
  "check_ids": [
    "text"
  ],
  "from_datetime": "2025-08-25T12:16:55.250Z"
}
{
  "total": 1,
  "page": 1,
  "size": 1,
  "data": [
    {
      "result_id": "text",
      "scan_time": "2025-08-25T12:16:55.250Z",
      "level": "text",
      "check_id": "text",
      "check_name": "text",
      "created_at": "2025-08-25T12:16:55.250Z",
      "dataset_id": "text",
      "organization_id": "text",
      "metric_value": 1,
      "owner_id": "text",
      "owner_first_name": "text",
      "owner_last_name": "text",
      "owner_email": "text",
      "owner_job_title": "text",
      "owner_phone_number": "text",
      "owner_user_type": "text",
      "attributes": {
        "ANY_ADDITIONAL_PROPERTY": [
          "text"
        ]
      }
    }
  ]
}

Dataset health [Paginated]

post

This endpoint provides you with a daily measure of the health of each of your datasets. Soda calculates a dataset's health based on the number of checks that pass during a scan. In calculating health, this endpoint returns an aggregation of the pass results from multiple scans on the same day.

Usage

Use this endpoint to get review the health of your datasets, and to see a high-level view of the more granular information that the /check_results endpoint provides.

Use this endpoint in conjunction with the /datasets endpoint as the latter adds information about each dataset.

Multiple dataset_ids are allowed per request, and use the from_datetime parameter to optimize performance.

Use the datasets endpoint to first get a list of available datasets along with their IDs, then issue separate queries one dataset at a time.

Keep the number of potentially parallel queries that you make to this endpoint small as they can face rate limitations or poor performance.

Returns

An object of type DatasetHealthResult containing an array of DatasetHealthData

Find details about the response objects in the Schemas section or by unfurling the response details.

Authorizations
Body
all ofOptionalDefault: {"page":1,"size":400}
Responses
200

Successful Response

application/json
202

Successful request but no data was returned

application/json
422

Validation Error

application/json
post
POST /v1//quality/dataset_health HTTP/1.1
Host: reporting.cloud.soda.io
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "page": 1,
  "size": 400,
  "dataset_ids": [
    "text"
  ],
  "from_datetime": "2025-08-25T12:16:55.250Z"
}
{
  "total": 1,
  "page": 1,
  "size": 1,
  "data": [
    {
      "organization_id": "text",
      "dataset_id": "text",
      "scan_date": "2025-08-25T12:16:55.250Z",
      "critical": 1,
      "info": 1,
      "warning": 1,
      "number_of_checks": 1,
      "percentage_passing_checks": 1,
      "last_point_percent_change": 1,
      "percent_change_percentage_passing_checks": 1,
      "number_of_distinct_checks": 1,
      "percentage_passing_distinct_passing_checks": 1,
      "last_point_distinct_checks_percent_change": 1,
      "percent_change_percentage_distinct_passing_checks": 1
    }
  ]
}