terraform/website/source/docs/enterprise/api/states.html.md

layout	page_title	sidebar_current	description
enterprise	State - API - Terraform Enterprise	docs-enterprise-api-states	State represents the status of your infrastructure at the last time Terraform was run.

State API

State represents the status of your infrastructure at the last time Terraform was run. States can be pushed to Terraform Enterprise from Terraform's CLI after an apply is done locally, or state is automatically stored if the apply is done in Terraform Enterprise.

List of States

This endpoint gets a list of states accessible to the user corresponding to the provided token.

Method	Path
GET	/terraform/state

Parameters

• ?username (string: "") - Specifies the organization/username to filter states

• ?page (int: 1) - Specifies the pagination, which defaults to page 1.

Sample Requests

$ curl \
    --header "X-Atlas-Token: ..." \
    https://atlas.hashicorp.com/api/v1/terraform/state

$ curl \
    --header "X-Atlas-Token: ..." \
    https://atlas.hashicorp.com/api/v1/terraform/state?username=acme

Sample Response

{
  "states": [
    {
      "updated_at": "2017-02-03T19:52:37.693Z",
      "environment": {
        "username": "my-organization",
        "name": "docs-demo-one"
      }
    },
    {
      "updated_at": "2017-04-06T15:48:49.677Z",
      "environment": {
        "username": "my-organization",
        "name": "docs-demo-two"
      }
    }
  ]
}