---
title: "Read authoritative owned attempt state"
method: GET
path: "/api/plugin_connection_attempts/{id}"
tags: ["Provider authorization"]
---

# Read authoritative owned attempt state

`GET /api/plugin_connection_attempts/{id}`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/plugin_connection_attempts/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

Attempt state without launch ticket or provider data

- object
  - `data` PluginConnectionAttempt
    - `id` string, uuid, required
    - `state` 'pending' | 'exchanging' | 'exchanged' | 'connected' | 'denied' | 'failed' | 'expired' | 'cancelled', required
    - `expires_at` string, date-time, required
    - `connection_id` string, required
    - `launch_url` string, uri
    - `target` object, required
      - `kind` 'instance' | 'installation', required
      - `id` union, required
        - integer
        - string, uuid

---

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