MatchesGroup
items object[]required
Array of matches for this source
Unique match ID
Partially visible name and username (e.g., "O*** Black"). Both name and username are blurred, showing only first letter followed by blur symbols
Whether the name is blurred. Note: consensusName is only available after matches are selected (see SearchResultsResponse)
Social network source identifier
Possible values: [fb, ig, tt, tw]
fbThumbnail image URL
Username on the social network
Whether this match is selected
Match confidence score 0–1 (included only for admin role)
Derived match-confidence tier. best when score > 0.7, likely when 0.55 <= score <= 0.7, absent/null below 0.55. Computed server-side; available to ALL roles (unlike score, admin-only).
Possible values: [best, likely]
When true, account is excluded from search results by law (e.g. GDPR). Only present when true.
Cursor for the next page. If null, there are no more items available. Use this cursor in the next request with the same endpoint and limit parameter.
Total number of items available. Optional field, may be omitted in additional pagination requests to reduce response size and improve performance.
Social network source identifier
Possible values: [fb, ig, tt, tw]
fbWhen true, the current user is an admin viewing another user's search; UI should be read-only (no select/delete/actions).
{
"items": [
{
"id": "match_001",
"partialName": "O*** Black",
"isBlurred": true,
"source": "fb",
"thumbnail": "https://cdn.face2social.com/thumbs/match_001.jpg",
"username": "o.black",
"selected": false
}
],
"nextCursor": "string",
"total": 0,
"source": "fb",
"read_only": true
}