交換した人の一覧

GET/meet-logs/contacts

名刺交換した相手を、最後に交換した順に返します。同じ相手と何度交換しても 1 人 1 件です。既定では個人どうしの交換だけを返します。includeCommunities=true でコミュニティと交換した名刺も混ぜ、asCommunityId でそのコミュニティが交換した相手の一覧（管理者のみ）に切り替えます。

認証	要ログイン

クエリパラメータ

pagenumber任意

ページ番号（既定 1）。

perPagenumber任意

1 ページの件数（既定 20、上限 50）。

keywordstring任意

名前・ユーザー名・肩書きの部分一致。半角・全角スペースで区切ると AND 検索。コミュニティの名刺は、コミュニティの名前・slug に当たります。

includeCommunitiesboolean任意

true なら、自分がコミュニティと交換した名刺も混ぜます。その項目は community に要約が入り、user は最後に交換を担当した管理者です。省略時は個人どうしの交換だけ（community は常に null）。

asCommunityIdstring任意

指定すると、そのコミュニティが交換した相手の一覧を返します（承認済みの管理者のみ）。項目は MeetLogCommunityScopeContact になり、開示されたメールアドレス・メルマガの購読・最後に担当した管理者が付きます。

補足

asCommunityId のコミュニティの管理者でなければ 403（errorCode 40208）です。コミュニティの一覧は現在の管理者全員で共有し、誰が担当した交換でも返します。

asCommunityId を指定したときの email は、相手がメールアドレスを共有しているか、そのコミュニティのメルマガを購読しているときに入ります（公式アプリのみ）。

相手が開示したメールアドレスは、4S の公式アプリにだけ返します。それ以外のアプリでは email は常に null です。

レスポンス

フィールド	型	説明
`contacts`	MeetLogContact[] \| MeetLogCommunityScopeContact[]	交換した人。asCommunityId を指定したときは MeetLogCommunityScopeContact。
`pageInfo`	PageInfo	ページ情報。

リクエスト

curl https://api.4s.link/meet-logs/contacts \
  -H "Authorization: Bearer 4s_at_..."

レスポンス例

{
  "contacts": [
    {
      "user": { "id": "u-taro", "slug": "taro", "firstName": "Taro", "lastName": "Yamada", "nativeName": "山田 太郎", "avatarUrl": "https://...", "title": "代表取締役", "bio": null, "cardDesign": "gradient-01-cobalt-mint", "cardPhoto": null, "organization": null },
      "community": null,
      "exchangeCount": 2,
      "firstExchangedAt": "2026-07-08T01:00:00.000Z",
      "lastExchangedAt": "2026-07-10T06:30:12.000Z",
      "lastEvent": { "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 }
    }
  ],
  "pageInfo": { "totalCount": 4, "totalPages": 1, "page": 1, "perPage": 20 }
}