SearchHistoryResponse
items object[]required
Array of search history items
Search ID
When the search was created (included only for admin role)
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.
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]
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.
{
"items": [
{
"id": "67489a2b3f4a210002",
"createdAt": "2025-11-28T14:30:00Z",
"thumbnail": "https://cdn.face2social.com/uploads/67489a2b3f4a210002_thumb.jpg",
"status": "completed",
"matchCount": 5,
"hasResults": true
}
],
"nextCursor": "string",
"total": 0
}