Skip to main content

SearchStatusResponse

searchIdstringrequired

Search task ID

statusSearchStatus (string)required

Search processing status

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

messagestring

Optional status message

thumbnailstring

The searched face cropped from the uploaded photo. Set only while status is preview, and only once the face is known. Omitted when this search was created without uploaded-photo retention, including status-stream events.

showAgeRestrictionPopupboolean

When true, frontend should show age restriction popup (face age at or below configured limit)

hasResultsboolean

True once matches have been selected (POST /search/{searchId}/select succeeded); the matches list is then closed and results are read via GET /search/{searchId}/results. Set on GET /search/{searchId}/status and the initial status-stream event; absent on later stream updates.

read_onlyboolean

When true, the current user is an admin viewing another user's search; UI should be read-only (no select/delete/actions).

SearchStatusResponse
{
"searchId": "string",
"status": "processing",
"message": "string",
"thumbnail": "string",
"showAgeRestrictionPopup": true,
"hasResults": true,
"read_only": true
}