---
title: "Get connection status"
method: GET
path: "/v1/integrations/connect/{connect_id}/status"
tags: ["Integrations"]
---

# Get connection status

`GET /v1/integrations/connect/{connect_id}/status`

## Request

- Base URL: `https://app.nex.ai/api/developers`
- URL: `https://app.nex.ai/api/developers/v1/integrations/connect/{connect_id}/status`
- Auth: API key in header `Authorization`

Polls the status of an in-progress OAuth connection. The connect_id is returned by the Start OAuth Connection endpoint. Poll this endpoint until the status changes from "pending" to "connected". The connect_id expires after 10 minutes.

## Path parameters

- `connect_id` string, required

## Response `200`

Current connection status

- DeveloperConnectStatusResponse
  - `status` 'pending' | 'connected': Connection status: "pending" while waiting, "connected" when complete
  - `connection_id` integer: ID of the newly created connection (only present when status is "connected")

## Other responses

- `400`: Invalid connect_id
- `401`: Unauthorized - Invalid or missing API key
- `410`: Connect ID has expired (10 minute TTL)
- `500`: Internal server error

## Changes

- **2026-03-07** `03024fd5cd66`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nex/apis/nex-developer-api/changes/v1/integrations/connect/:connect_id/status/get.md)

---

[API](https://skmtc.dev/nex/apis/nex-developer-api.md) - [All operations](https://skmtc.dev/nex/apis/nex-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nex/apis/nex-developer-api/revisions/51003af13108?raw)