SearchHistoryItem
Search ID
When the search was created (included only for admin role)
The searched face cropped from the uploaded photo, or the whole uploaded photo when no face crop is available. Photos in search history are never blurred as they are user's own uploads. Omitted when imageNotRetained is true, even while temporary image bytes still exist.
Optional plain-text title captured on the first upload attempt. Render as text; when absent or blank, use a localized search date and short-ID fallback, never a filename.
Possible values: <= 120 characters
Emitted only as true when this search's immutable policy disables uploaded-photo retention. Its thumbnail is omitted; render title or fallback without mounting an image. Absent means retained, independently of today's user policy.
Search processing status
Possible values: [processing, completed, error, preview]
Number of matches found
Whether the search has results available (matches were selected and credit was deducted).
- If
true: user can directly access results (GET /search/{searchId}/results) - If
false: user needs to select matches first (POST /search/{searchId}/select) before accessing results
Social networks where matches were found
Possible values: [fb, ig, tt, tw, li]
{
"id": "67489a2b3f4a210002",
"createdAt": "2025-11-28T14:30:00Z",
"thumbnail": "https://cdn.face2social.com/uploads/67489a2b3f4a210002_thumb.jpg",
"status": "completed",
"matchCount": 5,
"hasResults": true
}