> For the complete documentation index, see [llms.txt](https://docs.soda.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.soda.io/home.md).

# Home

<h2 align="center"><strong>Soda Docs</strong></h2>

<p align="center">Find what you need, explore the APIs, or start with the quickstart.</p>

<p align="center"><button type="button" class="button primary" data-action="search" data-icon="magnifying-glass">Search the docs…</button></p>

<p align="center"><a href="/soda-documentation/quickstart.md" class="button primary medium">Quickstart</a><a href="/soda-documentation/soda-ai.md" class="button primary medium">Soda AI</a><a href="/soda-documentation/soda-ai/rca-agent.md" class="button primary medium">RCA agent</a><a href="/soda-documentation/reference/contract-language-reference.md" class="button primary medium">Contract Language reference</a><a href="https://docs.soda.io/apis/" class="button primary medium">Soda APIs</a></p>

***

<h3 align="center">Work with Soda</h3>

<p align="center">Find data quality issues, understand why they happened, and fix them at the source.</p>

<table data-column-title-hidden data-view="cards"><thead><tr><th>Stage</th><th>Capability</th><th>Description</th><th>Resources</th><th data-hidden data-card-target data-type="content-ref">Explore</th></tr></thead><tbody><tr><td><mark style="color:$primary;"><strong>1 → FIND</strong></mark></td><td><strong>Detect issues</strong></td><td>Catch the problems you expect and the ones you don't.</td><td><a href="/soda-documentation/soda-v3/data-contracts.md" class="button secondary small">Data contracts</a> <a href="/soda-documentation/data-observability/metric-monitoring-dashboard.md" class="button secondary small">Metric monitoring</a> <a href="/soda-documentation/data-observability/rad-record-level-anomaly-detection.md" class="button secondary small">Record-Level Anomaly Detection</a><a href="/soda-documentation/data-testing/data-standards.md" class="button secondary small">Data standards</a></td><td><a href="/soda-documentation/data-observability.md">Data Observability</a></td></tr><tr><td><mark style="color:$primary;"><strong>2 → UNDERSTAND</strong></mark></td><td><strong>Investigate</strong></td><td>Dig into failures down to the rows and find the root cause.</td><td><a href="/soda-documentation/manage-issues/analyze-monitor-and-check-results.md" class="button secondary small">Analyze results</a> <a href="https://app.gitbook.com/s/A2PmHkO5cBgeRPdiPPOG/manage-issues/dataset-page" class="button secondary small">Dataset page</a> <a href="https://app.gitbook.com/s/A2PmHkO5cBgeRPdiPPOG/soda-ai/rca-agent" class="button secondary small">RCA agent</a><a href="/soda-documentation/diagnostics-warehouse.md" class="button secondary small">Diagnostics warehouse</a></td><td><a href="/soda-documentation/soda-ai/rca-agent.md">Root cause analysis (RCA) agent</a></td></tr><tr><td><mark style="color:$primary;"><strong>3 → FIX</strong></mark></td><td><strong>Respond</strong></td><td>Alert the right people and track issues to resolution.</td><td><a href="https://app.gitbook.com/s/A2PmHkO5cBgeRPdiPPOG/manage-issues/notifications" class="button secondary small">Notifications</a> <a href="https://app.gitbook.com/s/A2PmHkO5cBgeRPdiPPOG/manage-issues/incidents" class="button secondary small">Incidents</a> <a href="https://app.gitbook.com/s/A2PmHkO5cBgeRPdiPPOG/dataset-attributes-and-responsibilities" class="button secondary small">Ownership</a></td><td><a href="/soda-documentation/manage-issues/notifications.md">Notifications</a></td></tr></tbody></table>

***

{% columns %}
{% column width="50%" %} <mark style="color:$primary;">**DATA RECONCILIATION**</mark>

### Prove your data arrived intact

Compare a target dataset against one or more sources, from row counts and aggregates down to individual records. Use it to sign off a migration, validate a pipeline run, or keep systems in sync.

<a href="https://app.gitbook.com/s/A2PmHkO5cBgeRPdiPPOG/data-testing/data-reconciliation" class="button primary">Data reconciliation</a>&#x20;

<a href="/soda-documentation/reference/contract-language-reference/reconciliation-checks.md" class="button secondary">Reconciliation checks syntax</a>
{% endcolumn %}

{% column width="50%" %}
{% code overflow="wrap" %}

```yaml
dataset: snowflake/analytics/public/orders

reconciliation:
  sources:
    - name: legacy
      dataset: mysql/shop/public/orders
  checks:
    - row_count_diff:
        source: legacy
        threshold:
          must_be_less_than: 1
```

{% endcode %}
{% endcolumn %}
{% endcolumns %}

***

<h3 align="center">Build with Soda</h3>

<table data-column-title-hidden data-view="cards"><thead><tr><th>Title</th><th>Description</th><th>Resources</th><th data-hidden data-card-target data-type="content-ref">Learn more</th></tr></thead><tbody><tr><td><strong>Soda AI</strong></td><td>Let AI agents write contracts and find root causes.</td><td><a href="/soda-documentation/soda-ai/soda-mcp.md" class="button secondary small">Soda MCP</a> <a href="/soda-documentation/soda-ai/contract-autopilot.md" class="button secondary small">Contract Autopilot</a> <a href="/soda-documentation/soda-ai/bring-your-own-key-byok.md" class="button secondary small">BYOK</a></td><td><a href="/soda-documentation/soda-ai.md">Soda AI</a></td></tr><tr><td><strong>Integrate</strong></td><td>Connect Soda to your catalog, chat, and ticketing tools.</td><td><a href="/soda-documentation/integrations.md" class="button secondary small">Integrations</a> <a href="/soda-documentation/integrations/slack.md" class="button secondary small">Slack</a> <a href="/soda-documentation/integrations/collibra.md" class="button secondary small">Collibra</a></td><td><a href="/soda-documentation/integrations.md">Integrations</a></td></tr><tr><td><strong>Developer tools</strong></td><td>Work with Soda from code, the CLI, and the API.</td><td><a href="/soda-documentation/reference/soda-cli-reference.md" class="button secondary small">Soda CLI reference</a> <a href="/soda-documentation/soda-v3/data-source-reference.md" class="button secondary small">Data source reference</a> <a href="/soda-documentation/deployment-options/soda-python-libraries.md" class="button secondary small">Python libraries</a></td><td><a href="/soda-documentation/reference.md">Reference</a></td></tr></tbody></table>

***

<h3 align="center">Set up and manage Soda</h3>

<p align="center">Deploy Soda, connect your data, and decide who owns what.</p>

<table data-column-title-hidden data-view="cards"><thead><tr><th>Title</th><th>Description</th><th>Resources</th><th data-hidden data-card-target data-type="content-ref">Learn more</th></tr></thead><tbody><tr><td><strong>Deploy</strong></td><td>Choose where your scans run.</td><td><a href="/soda-documentation/deployment-options.md#soda-hosted" class="button secondary small">Soda-hosted Runner</a> <a href="/soda-documentation/deployment-options.md#self-hosted-runner" class="button secondary small">Self-hosted Runner</a> <a href="/soda-documentation/deployment-options.md#soda-python-libraries" class="button secondary small">Python libraries</a></td><td><a href="/soda-documentation/deployment-options.md">Deployment options</a></td></tr><tr><td><strong>Connect</strong></td><td>Bring your data sources and datasets into Soda.</td><td><a href="/soda-documentation/onboard-data-sources-and-datasets/onboard-datasets-on-soda-cloud.md" class="button secondary small">Via Soda Cloud</a> <a href="/soda-documentation/onboard-data-sources-and-datasets/via-soda-core.md" class="button secondary small">Via Soda Core</a> <a href="/soda-documentation/quickstart/supported-data-sources.md" class="button secondary small">Supported data sources</a></td><td><a href="/soda-documentation/onboard-data-sources-and-datasets.md">Onboard data sources &amp; datasets</a></td></tr><tr><td><strong>Govern</strong></td><td>Control who owns, sees, and changes what.</td><td><a href="/soda-documentation/organization-and-admin-settings.md" class="button secondary small">Admin settings</a> <a href="/soda-documentation/organization-and-admin-settings/global-and-dataset-roles.md" class="button secondary small">Roles</a> <a href="/soda-documentation/dataset-attributes-and-responsibilities.md" class="button secondary small">Attributes &#x26; responsibilities</a></td><td><a href="/soda-documentation/organization-and-admin-settings.md">Organization and Admin settings</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.soda.io/home.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.