Skip to main content

SearchHistoryItem

idstringrequired

Search ID

createdAtstring<date-time>nullable

When the search was created (included only for admin role)

thumbnailstring<uri>

Thumbnail of the uploaded photo. This is the original photo uploaded by the user, not blurred. Photos in search history are never blurred as they are user's own uploads.

statusSearchStatus (string)required

Search processing status

Possible values: [processing, completed, error, preview]

matchCountinteger<uint32>required

Number of matches found

hasResultsbooleanrequired

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
sourcesSource (string)[]

Social networks where matches were found

Possible values: [fb, ig, tt, tw]

SearchHistoryItem
{
  "id": "67489a2b3f4a210002",
  "createdAt": "2025-11-28T14:30:00Z",
  "thumbnail": "https://cdn.face2social.com/uploads/67489a2b3f4a210002_thumb.jpg",
  "status": "completed",
  "matchCount": 5,
  "hasResults": true
}