Skip to main content
GET
Poll upload status
Poll this endpoint with the uploadId returned from Upload faces until status is a terminal value (2, 3, or 4). Returns 404 if the upload does not exist or is not owned by your company.

Status values

Example response

200 OK — partially completed

Example cURL

Error responses

Authorizations

Authorization
string
header
required

Use Bearer {your_api_token} in the Authorization header, or HMAC signature headers (X-HMAC-SIGNATURE, X-TIMESTAMP, X-USER-ID). Same authentication as other v3 endpoints.

Headers

Accept
string
default:application/json
Authorization
string
required
Example:

"Bearer {your_api_token}"

Path Parameters

uploadId
string<uuid>
required

The upload UUID returned from POST /api/v3/duplicate-detection/faces.

Example:

"3aa8f48e-8a62-4439-82b9-bc3ae4b176a2"

Response

Upload status retrieved successfully

success
boolean
data
object