Terraform Cloud: How to read the state of a workspace through the API

I am considering to host my Terraform project on Terraform Cloud, app.terraform.io. But it is critical for me to be able to query the state file (terraform.tfstate.d/<workspace>/terraform.tfstate) through the API. However, it is unclear to me, reading through the docs, how to do this. Anyone who could enlighten me?

Hi @chjoerg, does https://www.terraform.io/docs/cloud/api/state-versions.html#fetch-the-current-state-version-for-a-workspace do what you need?