---
title: "Poll a connect request; returns the API key exactly once"
method: GET
path: "/api/v1/agent/connect/{id}"
---

# Poll a connect request; returns the API key exactly once

`GET /api/v1/agent/connect/{id}`

## Request

- Base URL: `https://www.premierletters.com`
- URL: `https://www.premierletters.com/api/v1/agent/connect/{id}`
- Auth: none required

## Path parameters

- `id` string, uuid, required

## Query parameters

- `secret` string, required

## Response `200`

pending | denied | expired | claimed, or approved with api_key (returned once)

- ConnectStatus
  - `status` 'pending' | 'approved' | 'claimed' | 'denied' | 'expired'
  - `api_key` string: Only with status approved, and only once. Save it.
  - `mode` 'live' | 'test'

## Other responses

- `404`: No request matches this id and secret
- `429`: rate_limited: polling too fast

---

[API](https://skmtc.dev/premierletters/apis/premier-letters-api.md) · [All operations](https://skmtc.dev/premierletters/apis/premier-letters-api/llms.txt) · [OpenAPI document](https://skmtc.dev/premierletters/apis/premier-letters-api/revisions/72f072e21947?raw)