---
title: "List Buzz human adoptions for an owned organization"
method: GET
path: "/buzz-human-adoptions/v1"
tags: ["Buzz Control Plane"]
---

# List Buzz human adoptions for an owned organization

`GET /buzz-human-adoptions/v1`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/buzz-human-adoptions/v1`
- Auth: one of:
  - API key in header `SIGN-IN-WITH-X`
  - HTTP bearer

## Query parameters

- `org_id` string, uuid, required: A Run402 organization id, exactly as returned by GET /agent/v1/whoami, GET /orgs/v1 and GET /projects/v1. Buzz owns no organizations of its own.

## Response `200`

Authorized adoption list

- object
  - `buzz_human_adoptions` BuzzHumanAdoption[], required
    - `buzz_human_adoption_id` string, required
    - `buzz_human_adoption_offer_id` string, nullable
    - `org_id` string, uuid, required: A Run402 organization id, exactly as returned by GET /agent/v1/whoami, GET /orgs/v1 and GET /projects/v1. Buzz owns no organizations of its own.
    - `identity_link_id` string
    - `initiating_agent_identity_link_id` string, required: Public attribution link held by the initiating agent; not organization authority.
    - `human_identity_link_id` string, nullable, required: Public attribution link created or reused for the adopting human after completion; not organization authority.
    - `status` 'pending' | 'completed' | 'expired' | 'cancelled', required
    - `owner_proof_content` BuzzHumanAdoptionOwnerProofContent: Exact public five-minute Buzz owner-consent challenge. Offer-backed attempts use the released browser_fragment_v1 callback; direct compatibility attempts use clipboard return.
      - `deep_link` string, required
      - `challenge_id` string, uuid, required
      - `nonce` string, required
      - `verification_code` string, required
      - `audience` 'buzz:nostr-identity', required
      - `action` 'bind_nostr_identity', required
      - `protocol` 'buzz-nostr-identity', required
      - `version` '1', required
      - `origin` 'https://console.run402.com', uri, required
      - `expires_at` string, date-time, required
      - `return` 'clipboard' | 'browser_fragment_v1', required
      - `callback_url` string, uri, nullable, required
    - `owner_proof_event_id` string, nullable
    - `adopting_human_principal_id` string, nullable
    - `target_human_principal_id` string, nullable
    - `membership_id` string, nullable
    - `authority_effects` object, nullable, required: Non-null after completed adoption. The ordinary membership (role owner) is the sole organization-authority effect; the public identity link and terminal consent receipt are independently revocable/retained resources.
      - `human_membership_role` 'owner', required
      - `initiating_agent_membership_changed` false, required
      - `organization_ownership_transferred` false, required
      - `projects_transferred` false, required
      - `credentials_shared` false, required
    - `issued_at` string, date-time, required
    - `expires_at` string, date-time, required
    - `consumed_at` string, date-time, nullable
    - `activated_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `expired_at` string, date-time, nullable, required
    - `cancelled_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `drift` object[], required
    - `next_actions` BuzzNextAction[], required
      - `type` string, required
      - `method` 'GET' | 'POST' | 'PATCH' | 'DELETE'
      - `path` string
      - `field` string: Exact rejected request field or header when the repair is field-specific.
      - `auth` string, required
      - `why` string, required
      - `safe_to_auto_execute` boolean, required
      - `requires_approval` boolean, required
      - `destructive` boolean, required
      - `idempotent` boolean, required
      - `spend_impact` object, required
        - `currency` 'USD', required
        - `max_amount` '0', required

## Other responses

- `403`: Canonical Buzz control-plane error. Authorization is existence-obscuring; proof failures never consume a challenge or partially create authority.

---

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