Get a card exchange

GET/card-exchanges/:exchangeId

Return the exchange as seen by a participant. The requester polls this while waiting, and moves on with result once status becomes ACCEPTED. When result.candidateEvents has at least one event, ask where you met and record eventId with PATCH /meet-logs/:meetLogId (a single candidate is already recorded in result.eventId, so show it selected and send eventId: null if it is cleared).

Auth	Login required

Path parameters

exchangeIdstringrequired

Exchange ID.

Notes

Declined, canceled or superseded exchanges are deleted, so they return 404 (errorCode 40203). Non-participants also get 404.

Response

Returns CardExchange.

Request

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

Example response

{
  "id": "6f1c2d3e-...",
  "status": "ACCEPTED",
  "role": "REQUESTER",
  "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": "2026-07-10T06:30:12.000Z",
  "myShareEmail": true,
  "mySubscribeNewsletter": null,
  "result": {
    "exchangedAt": "2026-07-10T06:30:12.000Z",
    "meetLogId": "ml-1",
    "eventId": null,
    "candidateEvents": [
      { "id": "ev-1", "slug": "ivs-2026", "title": "IVS 2026", "languages": null, "startTime": "2026-07-08T10:00:00.000Z", "endTime": "2026-07-10T18:00:00.000Z", "timezone": "Asia/Tokyo", "thumbnailUrl": null, "mainImageUrl": null },
      { "id": "ev-2", "slug": "ivs-side-a", "title": "サイドイベントA", "languages": null, "startTime": "2026-07-10T15:00:00.000Z", "endTime": "2026-07-10T20:00:00.000Z", "timezone": "Asia/Tokyo", "thumbnailUrl": null, "mainImageUrl": null }
    ]
  }
}