---
title: "List remote state consumers"
method: GET
path: "/workspaces/{workspace}/relationships/remote-state-consumers"
tags: ["remote-state-consumers"]
---

# List remote state consumers

`GET /workspaces/{workspace}/relationships/remote-state-consumers`

## Request

- Base URL: `https://example.scalr.io/api/iacp/v3`
- URL: `https://example.scalr.io/api/iacp/v3/workspaces/{workspace}/relationships/remote-state-consumers`
- Auth: HTTP bearer

This endpoint returns a list of other workspaces
that that were explicitly added as state consumers for given workspace.

## Path parameters

- `workspace` string, required

## Query parameters

- `page[number]` string
- `page[size]` string

## Response `200`

Request was successful.

- RemoteStateConsumerRelationshipFieldsetsListingDocument: Document Listing.
  - `data` RemoteStateConsumerRelationship[]
    - `id` string, required
    - `type` 'workspaces', required
  - `included` object[]
  - `links` object
  - `meta` object

## Other responses

- `403`: User unauthorized to perform this action.
- `404`: Workspace not found, or user unauthorized to perform action.
- `4XX`: Client error.
- `5XX`: Server error.

---

[API](https://skmtc.dev/scalr/apis/scalr-iacp-api.md) - [All operations](https://skmtc.dev/scalr/apis/scalr-iacp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalr/apis/scalr-iacp-api/revisions/d3e1dc85657a?raw)