> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify and Gorgias connection status (identifiers, never tokens)

> Connection status for Shopify, Gorgias and the knowledge base. Tokens are reduced to booleans and never returned.

### Response

`object`

<ResponseField name="object" type="string" required />

<ResponseField name="shopify" type="object" required>
  <Expandable title="shopify">
    <ResponseField name="connected" type="boolean" required>
      True when both a shop handle and an access token are stored.
    </ResponseField>

    <ResponseField name="shop" type="string,null" required>
      The myshopify handle.
    </ResponseField>

    <ResponseField name="scopes" type="string,null" required>
      Comma-separated granted scopes, when known.
    </ResponseField>

    <ResponseField name="connect_url" type="string,null" required>
      The OAuth path (`/api/shopify/login`) for a human to complete in a browser; null once connected.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="gorgias" type="object" required>
  <Expandable title="gorgias">
    <ResponseField name="connected" type="boolean" required>
      True when both a domain and an API key are stored.
    </ResponseField>

    <ResponseField name="domain" type="string,null" required>
      The Gorgias account handle.
    </ResponseField>

    <ResponseField name="username" type="string,null" required>
      The agent email the API key belongs to.
    </ResponseField>

    <ResponseField name="connect_url" type="string,null" required>
      The OAuth path (`/api/gorgias/login-router`) for a human to complete in a browser; null once connected.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="knowledge_base" type="object" required>
  <Expandable title="knowledge_base">
    <ResponseField name="configured" type="boolean" required>
      Whether a knowledge-base collection has been provisioned for the org.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="next_action" type="string" required>
  A one-sentence suggestion: connect Shopify, connect Gorgias, or refresh store knowledge.
</ResponseField>

### Status codes

| Code  | Meaning                                                                                                           |
| ----- | ----------------------------------------------------------------------------------------------------------------- |
| `200` | Connection status for Shopify, Gorgias and the knowledge base. Tokens are reduced to booleans and never returned. |
| `401` | Missing, invalid, or expired API key.                                                                             |
| `403` | The key lacks a required scope.                                                                                   |
| `429` | Rate limit exceeded.                                                                                              |

### Access

|                |                         |
| -------------- | ----------------------- |
| Required scope | `agents:read`           |
| Rate limit     | 120 requests per minute |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://response.stateset.com/api/v1/integrations' \
    --header "Authorization: Bearer $RESPONSECX_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "integrations",
    "shopify": {
      "connected": true,
      "shop": "string",
      "scopes": "string",
      "connect_url": "string"
    },
    "gorgias": {
      "connected": true,
      "domain": "string",
      "username": "string",
      "connect_url": "string"
    },
    "knowledge_base": {
      "configured": true
    },
    "next_action": "string"
  }
  ```
</ResponseExample>