GET
Skin Analysis Result
Polls the status and retrieves the result of a previously submitted skin analysis prediction using appId, scanId, and predictionId.
Note
Use the
predictionId returned by POST Generate Skin Analysis. Poll this endpoint until status updates.Parameters
appIdstring
ID of the Skin Analysis app configuration used for this prediction.
scanIdstring
Identifier of the specific scan instance created during generation.
predictionIdstring
Prediction ID (_id) returned by Generate Skin Analysis, used to fetch this job's result.
Tip
scanId is returned by POST Generate Skin Analysis. Use the same scanId and predictionId from the Generate step when calling this endpoint.Output Errors
This API can return HTTP 200 with
status: "SUCCESS" even if something fails, in these cases output contains an error key with error message and status_code: 422.| Error message | Status code | Notes |
|---|---|---|
| No face detected | 422 | No face detected in the provided image. Ensure the image contains a clear, visible face. |
| Failed to read Image | 422 | The image file could not be read or processed. Check if the file is valid and accessible. |
| File size exceeds 5MB limit. | 422 | Image file exceeds the maximum allowed size limit. Compress or resize the image before uploading. |
| Unable to open image. Invalid or corrupted file. | 422 | The image file is corrupted or in an invalid format. Try re-saving or re-exporting the image. |
| Unsupported image format. Only PNG, JPG, or JPEG is allowed. | 422 | The image format is not supported. Convert the image to PNG, JPG, or JPEG format. |
| Image dimensions are too small. Min required resolution 1024x1024 pixels. | 422 | Image resolution is below the minimum requirement. Use an image with higher resolution. |
| Image resolution too large. Max allowed resolution 2048x2048 pixels. | 422 | Image resolution exceeds the maximum allowed limit. Resize the image to a smaller resolution. |
GET/sa-predictions/apps/{appId}/plugins/skinAnalysisInt/scans/{scanId}/{predictionId}
curl -X GET "https://api.pixelbin.io/service/private/misc/v2.0/sa-predictions/apps/{appId}/plugins/skinAnalysisInt/scans/{scanId}/{predictionId}" \
-H "Authorization: Bearer {accesskey}"
Response
201
No example available.