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

# GET /v1/sdr/gmail/status

> Check the SDR's Gmail connection state via Composio.

Returns the connection health for the SDR linked to the API key.

```bash theme={null}
curl https://app.leadterra.co/v1/sdr/gmail/status \
  -H "Authorization: Bearer sk_live_your_key"
```

## Response

```json theme={null}
{
  "data": {
    "connected": true,
    "email": "jordan.sdr@gmail.com",
    "healthState": "active",
    "lastSyncedAt": "2026-06-28T18:00:00.000Z"
  }
}
```

<ResponseField name="data.connected" type="boolean">
  Whether the Gmail connection is active.
</ResponseField>

<ResponseField name="data.email" type="string">
  The connected Gmail address.
</ResponseField>

<ResponseField name="data.healthState" type="string">
  Connection state: `active`, `needs_reauth`, `rate_limited`, or `disconnected`.
</ResponseField>

<ResponseField name="data.lastSyncedAt" type="string">
  Timestamp of the last successful Gmail sync.
</ResponseField>

<ResponseField name="data.lastSyncError" type="string">
  Last sync error message, if any.
</ResponseField>