Get the current card exchange

GET/card-exchanges/current

Return the authenticated user's card exchange in progress, or null. Poll this while showing the My QR code, and open the confirmation screen when role is TARGET and status is PENDING.

Auth	Login required

Notes

The person who was asked also receives a push notification (data.type = CARD_EXCHANGE_REQUESTED, data.exchangeId). Some devices do not receive notifications, so keep polling while the QR code is shown.

This endpoint omits defaultShareEmail, defaultSubscribeNewsletter, previousExchange and result. Call GET /card-exchanges/:exchangeId when opening the confirmation screen.

counterpartCommunity holds the community's summary when a community is asking you, and myCommunity holds it when the request is addressed to a community you administer (someone scanned its card QR code).

Response

Field	Type	Description
`exchange`	CardExchange \| null	The current exchange.

Request

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

Example response

{
  "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
  }
}