---
title: "Get connection."
method: GET
path: "/connectors/connection/{connectionId}"
tags: ["data"]
---

# Get connection.

`GET /connectors/connection/{connectionId}`

Returns connection details for a given connection ID.

## Path parameters

- `connectionId` string, required

## Response `200`

OK

- NexusUserFacingConnectionInfo
  - `connectorParams` object
  - `created` string
  - `headers` object
  - `id` string — strip out user and s3_uri from the connection info, but return everything else from NexusConnectionWithStatus
  - `jobParams` object
  - `latestCompletedAt` string
  - `latestJobStatus` 'syncing' | 'synced' | 'failed' | 'loading' | 'ready'
  - `name` string
  - `nextRun` string — calculated
  - `schedule` object
  - `schedulingStatus` 'oneoff' | 'todo' | 'scheduling' | 'scheduled' | 'failed_to_schedule' | 'inactive' | 'paused' | 'source_unavailable' | 'active'
  - `skipNotification` boolean
  - `sourceFolder` string
  - `sourceType` 'snowflake' | 'snowflakeSSO' | 'snowflakeLiveQuery' | 'snowflakeSSOLiveQuery' | 'google-analytics-data-api' | 'hubspot' | 'mysql' | 'postgres' | 'salesforce' | 'salesforceReport' | 'freshsales' | 'databricks' | 'databricksDeltaShare' | 'databricksLiveQuery' | 'bigquery' | 'awsathena' | 'awsredshift' | 'mssql' | 'clickhouse' | 'clickhouseLiveQuery'
  - `updated` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/freshdesk/apis/gigasheet-api.md) · [All operations](https://skmtc.net/freshdesk/apis/gigasheet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freshdesk/gigasheet-api/versions/d1e5cbb24557/schema)