Get skin analysis history

Get paginated list of the user's skin analysis history, one record per scan batch. analysis_data.skin_concerns is the union of concern labels across all images in the batch (deduplicated, case-insensitive), so the full concern list is returned even though it is stored on a single image.

analysis_data.general_skin_health is an integer, rounded once here so two screens cannot disagree about the same scan, and is null - present, not absent - when nothing could be graded. analysis_data.general_skin_health_grade carries its band (SkinHealthGrade), also null when there is no score. Render "not assessed" for a null score; never fall back to 0, which reads as a real score of zero and bands as the worst grade.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
Defaults to 1

Page number for pagination

integer
Defaults to 10

Number of items per page

Filter results by batch ID or label

date

Filter scans created on or after this date (YYYY-MM-DD)

date

Filter scans created on or before this date (YYYY-MM-DD)

string
enum

When set to progress, returns only the user's own face scans: body add-ons are dropped and scans the identity check stamped as a different person (identity_passed = false, e.g. a borrowed phone) are hidden. A first scan and a scan still awaiting its identity check are included. Use this for trend charts and baseline math on the Progress screen. Omit for the default behavior (all scans).

Allowed:
Headers
string

mobile-app returns only face scans because mobile history and score charts do not support standalone body sessions. Other surfaces retain one entry per session; for=progress is always face-only.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json