# Get a connection

> Poll a connection until it is connected, then read the credential id.

Source: https://docs.generalinput.com/api/vault/get-connection



<Endpoint method="GET" path="/v1/connections/:id" />

<Access scope="vault:connect" />

Read the connection back. Poll every few seconds while `status` is `pending`; stop on any other value.

## Path parameters [#path-parameters]

| Name | Notes                                                                   |
| ---- | ----------------------------------------------------------------------- |
| `id` | The id returned by [create a connection](/api/vault/create-connection). |

## Response [#response]

The same shape as the create response. Once complete:

```json
{
  "id": "vconn_01HX…",
  "service": "hubspot",
  "status": "connected",
  "credentialId": "cred_01HY…",
  "connectedAt": "2026-09-03T10:04:12.000Z",
  "error": null
}
```

A `failed` status carries the reason in `error`. An `expired` status means the hour passed; create a new connection.

## Errors [#errors]

| Status | When                                                                                         |
| ------ | -------------------------------------------------------------------------------------------- |
| `404`  | No such connection, or it belongs to another member. Existence is not leaked across members. |