現在の名刺交換

GET/card-exchanges/current

認証中ユーザーの交換中の名刺交換を返します。交換中でなければ exchange は null です。マイ QR コードを表示している間にポーリングし、role が TARGET で status が PENDING なら、相手の申し込みを確認する画面を開いてください。

認証	要ログイン

補足

申し込まれた側にはプッシュ通知（data.type = CARD_EXCHANGE_REQUESTED, data.exchangeId）も送ります。通知が届かない端末もあるので、QR コードを表示している間はポーリングと併用してください。

このエンドポイントは defaultShareEmail・defaultSubscribeNewsletter・previousExchange・result を返しません。確認画面を開くときは GET /card-exchanges/:exchangeId を呼んでください。

コミュニティからの申し込みでは counterpartCommunity に、自分が管理しているコミュニティ宛ての申し込み（コミュニティの名刺の QR コードを読まれた）では myCommunity に、そのコミュニティの要約が入ります。

レスポンス

フィールド	型	説明
`exchange`	CardExchange \| null	現在の交換。

リクエスト

curl https://api.4s.link/card-exchanges/current \
  -H "Authorization: Bearer 4s_at_..."

レスポンス例

{
  "exchange": {
    "id": "6f1c2d3e-...",
    "status": "PENDING",
    "role": "TARGET",
    "counterpart": {
      "id": "u-taro",
      "slug": "taro",
      "firstName": "Taro",
      "lastName": "Yamada",
      "nativeName": "山田 太郎",
      "avatarUrl": "https://...",
      "title": "代表取締役",
      "bio": "企業の新規事業を支えるサービスを開発しています。",
      "cardDesign": "gradient-01-cobalt-mint",
      "cardPhoto": null,
      "organization": {
        "id": "org-1",
        "name": "株式会社HORIZON",
        "slug": "horizon",
        "logoUrl": null,
        "title": "ビジネス開発チーム"
      }
    },
    "counterpartCommunity": null,
    "myCommunity": null,
    "expiresAt": "2026-07-10T06:33:00.000Z",
    "createdAt": "2026-07-10T06:29:40.000Z",
    "requestedAt": "2026-07-10T06:30:00.000Z",
    "respondedAt": null,
    "myShareEmail": true,
    "mySubscribeNewsletter": null,
    "result": null
  }
}