Card exchange / Meet log

List exchanged contacts

GET/meet-logs/contacts

List the people you exchanged cards with, most recent first. Each person appears once no matter how many times you exchanged. By default only person-to-person exchanges are returned. includeCommunities=true mixes in the cards you exchanged with communities, and asCommunityId switches to the list of people that community exchanged with (admins only).

AuthLogin required

Query parameters

pagenumberoptional

Page number (default 1).

perPagenumberoptional

Items per page (default 20, max 50).

keywordstringoptional

Partial match on name, username or title. Separate words with spaces for an AND search. Community cards match on the community's name or slug.

includeCommunitiesbooleanoptional

When true, also returns the cards you exchanged with communities. Those items carry the summary in community, and user is the admin who last handled the exchange. When omitted, only person-to-person exchanges are returned (community is always null).

asCommunityIdstringoptional

When given, returns the people that community exchanged with (approved admins only). Items become MeetLogCommunityScopeContact, with the disclosed email, the newsletter subscription and the admin who last handled the exchange.

Notes

Returns 403 (errorCode 40208) when you are not an admin of the asCommunityId community. A community's list is shared by all its current admins and includes exchanges handled by any of them.

With asCommunityId, email is set when the person shares their email address or subscribes to the community's newsletter (official apps only).

Email addresses that the other person chose to share are returned only to official 4S apps. For other apps, email is always null.

Response

FieldTypeDescription
contactsMeetLogContact[] | MeetLogCommunityScopeContact[]Contacts; MeetLogCommunityScopeContact when asCommunityId is given.
pageInfoPageInfoPagination info.
Request
curl https://api.4s.link/meet-logs/contacts \
-H "Authorization: Bearer 4s_at_..."
Example response
{
"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 }
}