---
title: "Whether the caller has connected their warehouse identity."
method: GET
path: "/v1/connections/{id}/oauth/status"
tags: ["connections"]
---

# Whether the caller has connected their warehouse identity.

`GET /v1/connections/{id}/oauth/status`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/v1/connections/{id}/oauth/status`
- Auth: one of:
  - API key in cookie `dvt_session`
  - HTTP bearer

Reports whether the acting user has an active (non-revoked) per-user OAuth grant on
this connection (DVT-123). The SPA uses this to decide whether to show a "connect your
account" prompt. Any member (the answer is about the caller's own grant).

## Response `200`

The caller's grant status on this connection.

- object
  - `data` object, required
    - `connected` boolean, required: True when the caller has an active grant.
    - `approximateExpiry` string, date-time, nullable: Approximate refresh-token expiry, when the IdP disclosed one (for re-consent nudges).

## Other responses

- `401`: Missing, invalid, or expired session.

---

[API](https://skmtc.dev/dvt/apis/dvt-rest-api.md) · [All operations](https://skmtc.dev/dvt/apis/dvt-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dvt/apis/dvt-rest-api/revisions/00016f504165?raw)