> ## 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.

# Customer Session Status

> StateSet Voice API operation.

StateSet Voice API operation.

### Response

`object`

<ResponseField name="ok" type="boolean" required />

<ResponseField name="signup_enabled" type="boolean" required>
  Whether the customer self-serve plane is enabled on this server
</ResponseField>

<ResponseField name="authenticated" type="boolean" required>
  Whether the request carries a valid customer session cookie
</ResponseField>

<ResponseField name="authorize_url" type="string,null" required>
  Sign-in URL to start the OAuth flow; null when signup is disabled
</ResponseField>

### Status codes

| Code  | Meaning                                                                                    |
| ----- | ------------------------------------------------------------------------------------------ |
| `200` | Customer session status: whether signup is enabled and whether the caller is authenticated |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.voice.stateset.com/api/v1/customer/auth/session' \
    --header "Authorization: Bearer $STATESET_VOICE_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true,
    "signup_enabled": true,
    "authenticated": true,
    "authorize_url": "/api/v1/customer/auth/authorize?returnTo=%2Fapp"
  }
  ```
</ResponseExample>