---
title: "Get connector login"
method: GET
path: "/api/connectors/login/{loginId}"
---

# Get connector login

`GET /api/connectors/login/{loginId}`

## Request

- Base URL: `https://reduck.ai`
- URL: `https://reduck.ai/api/connectors/login/{loginId}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

How a sign-in started by `startConnectorLogin` is going: `waiting` (browser open, not signed in yet), `stored` (cookies saved, may still be refreshing), `done` (finished), `failed` (ended with nothing saved). `hosts` says how many cookies each site has so far.

## Path parameters

- `loginId` string, required

## Response `200`

OK

- object
  - `loginId` string, required
  - `status` 'waiting' | 'stored' | 'done' | 'failed', required
  - `loginUrl` string, required
  - `hosts` ConnectorLoginHost[], required
    - `host` string, required
    - `cookies` number, required: Cookies stored for this site; 0 until the sign-in lands.
    - `stored` boolean, required
  - `pageUrl` string: Where the browser stands, so the page can say whether the sign-in has moved.
  - `expiresAt` string, required
  - `error` string: Why nothing more will happen, when something went wrong.
  - `credential` ConnectorLoginCredential
    - `username` string
    - `password` string
  - `profile` string: The end-user profile the connectors are stored into; absent for your own account.
  - `label` string: The label of the connector the sign-in stores into, when it was given one.

## Other responses

- `401`: Not authenticated
- `403`: Forbidden
- `404`: No such sign-in on this account.

---

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