---
title: "List pending transfers offered TO the caller"
method: GET
path: "/agent/v1/transfers/incoming"
tags: ["Project Transfers"]
---

# List pending transfers offered TO the caller

`GET /agent/v1/transfers/incoming`

## Request

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

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Array of pending transfer summaries; each entry carries a preview_path the SDK / CLI / UI can deep-link to.

- object
  - `transfers` ProjectTransferSummary[]
    - `transfer_id` string, uuid
    - `project_id` string
    - `project_name_snapshot` string, nullable: Captured at init time; preserved post-purge for audit.
    - `recipient_kind` 'wallet' | 'email' | 'org': Recipient kind: wallet and email are both accepted via /accept (wallet by the to_wallet's SIWX signature, email by the addressed principal's sign-in session); org completes synchronously when the caller owns both organizations.
    - `from_wallet` string: Canonical-lowercase EIP-55 wallet (sender).
    - `to_wallet` string: Canonical-lowercase EIP-55 wallet (recipient). Omitted from incoming-list responses.
    - `to_email` string, email, nullable: Addressed email for email-kind transfers; null/omitted for wallet-kind transfers.
    - `from_org_id` string, uuid, nullable: Offering organization for email-kind transfers.
    - `billing_policy` 'migrate'
    - `message` string, nullable
    - `initiated_at` string, date-time
    - `expires_at` string, date-time
    - `kysigned_record_id` string, nullable
    - `preview_path` string: API path to GET the full preview document, e.g. /agent/v1/transfers/<transfer_id>.
    - `initiated_by` OperationActorSnapshot
      - `schema_version` 1, required
      - `principal` PrincipalSnapshot, required
        - `principal_id` string, required
        - `principal_type` string, required
        - `display_name_at_capture` string, nullable, required
        - `linked_identities_at_capture` LinkedIdentitySnapshot[], required
          - `identity_link_id` string, required
          - `kind` string, required
          - `public_subject` string, required
          - `display_subject` string, required
          - `verified_at` string, date-time, required
          - `status_at_capture` 'active', required
      - `authenticator` AuthenticatorSnapshot, required
        - `authenticator_id` string, required
        - `kind` string, required
        - `public_subject` string, required
      - `authority` AuthoritySnapshot, required: Discriminated immutable action-time authority: organization_membership, project_grant, grant_key, ci, system, legacy, or a preserved future kind. A link is never an authority kind.
        - `kind` string, required
        - `org_id` string, nullable
        - `project_id` string, nullable
        - `membership_id` string, nullable
        - `grant_id` string, nullable
        - `grant_key_id` string, nullable
        - `credential_id` string, nullable
        - `role` string, nullable
        - `scope` string[]
        - `reason_code` string, nullable
      - `captured_at` string, date-time, required
    - `source_organization` OrganizationReference
      - `org_id` string, uuid, required
    - `destination_organization` OrganizationReference
      - `org_id` string, uuid, required

---

[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)