---
title: "Get connection details"
method: GET
path: "/v1/platform/connections/{connectionId}"
tags: ["Platform"]
---

# Get connection details

`GET /v1/platform/connections/{connectionId}`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/platform/connections/{connectionId}`
- Auth: HTTP bearer

Returns connection status, claim state, wallet address, and provisioned resource IDs.
Use for polling the claim loop after bootstrap.

## Path parameters

- `connectionId` string, uuid, required

## Response `200`

Connection details

- ConnectionDetailResponse
  - `connection_id` string, uuid, required
  - `user_id` string, uuid, required
  - `email` string: The connected user's email, as returned by the upsert. Use it to recognise a returning user and begin a passkey ceremony from the connection alone.
  - `display_name` string
  - `status` string, required
  - `entitlement_status` string, required
  - `provisioned_tier` string, nullable: Billing tier granted to the end-user org when billing_model is platform_pays (from template plan at bootstrap). Null when not provisioned.
  - `wallet_address` string, nullable
  - `vault_ids` string[], required
  - `agent_ids` string[], required
  - `runtime_ids` string[]
  - `automation_ids` string[]
  - `claimed_at` string, date-time, nullable
  - `claim` ClaimStatusResponse, required
    - `status` 'pending' | 'active' | 'claimed', required
    - `redeemed_at` string, date-time, nullable

## Other responses

- `404`: Resource not found

---

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