About the Discovery API schema

With the Discovery API, you can query the metadata in dbt to learn more about your dbt deployments and the data they generate. You can analyze the data to make improvements. If you are new to the API, refer to About the Discovery API for an introduction. You might also find the use cases and examples helpful.

The Discovery API schema provides all the pieces necessary to query and interact with the Discovery API. The most common queries use the environment endpoint:

Environment schema

Query and compare a model’s definition (intended) and its applied (actual) state.

Applied schema

Query the actual state of objects and metadata in the warehouse after a `dbt run` or `dbt build`.

Definition schema

Query intended state in project code and configuration defined in your dbt project.

Model Historical Runs schema

Query information about a model's run history.

Was this page helpful?

Privacy policyCreate a GitHub issue

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.