Future Me

Create Future Me predictions based on user scans.

Use these endpoints to generate Future Me predictions that simulate how a user’s body shape and composition could change under different target conditions (for example, a lower body weight or body fat percentage). Predictions are always linked to an existing scan and can be queried or deleted independently of other scans.

All Future Me endpoints require the following headers:

accept: application/json;v=1
authorization: Bearer {{API_KEY}}
content-type: application/json

Replace {{API_KEY}} with your Prism API key for the selected environment.

Register a new body shape prediction

post

https://api.hosted.prismlabs.techhttps://sandbox-api.prism.hosted.com

/body-shape-prediction

This operation registers a new Future Me body shape prediction for a specific scan.

Use this endpoint to simulate how a user's body shape and composition could change for a given goal (for example, a lower target weight or body fat percentage).

Note: Either a target weight or a target body fat percentage must be specified, but not both at the same time.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

unit-systemstring · enumOptional

The unit system in which values will be returned.

Possible values:

Body

application/json

scanIdstringRequired

The unique ID of the scan within the Hosted API on which the body shape prediction is based.

Example: unique-scan-id

predictionTypestring · enumRequired

The prediction type that should be used for the prediction.

Example: weight_lossPossible values:

targetWeightnumber · min: 1Optional

The target weight in kg for the prediction. This or targetBodyfat should be specified, but not both.

Example: 50

targetBodyfatnumber · min: 1Optional

The target body fat percentage for the prediction. This or targetWeight should be specified, but not both.

Example: 20

Responses

201Success

application/json;v=1

post

/body-shape-prediction

HTTPcURLJavaScriptPython

POST /body-shape-prediction HTTP/1.1
Host: api.hosted.prismlabs.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "scanId": "unique-scan-id",
  "predictionType": "weight_loss",
  "targetWeight": 50,
  "targetBodyfat": 20
}

201Success

{
  "id": "unique-body-shape-prediction-id",
  "status": "PROCESSING",
  "scanId": "unique-scan-id",
  "predictionType": "weight_loss",
  "targetWeight": 50,
  "targetBodyfat": 20,
  "createdAt": "text",
  "updatedAt": "text"
}

Get status of a body shape prediction

get

https://api.hosted.prismlabs.techhttps://sandbox-api.prism.hosted.com

/body-shape-prediction/{bodyShapePredictionId}

This operation returns the current status and details of a specific body shape prediction.

Use this endpoint to poll the processing status after creating a prediction or to retrieve its latest state for display in your application.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

bodyShapePredictionIdstringRequired

The unique ID of the body shape prediction.

Example: unique-body-shape-prediction-id

Query parameters

unit-systemstring · enumOptional

The unit system in which values will be returned.

Possible values:

Responses

200Success

application/json;v=1

get

/body-shape-prediction/{bodyShapePredictionId}

HTTPcURLJavaScriptPython

GET /body-shape-prediction/{bodyShapePredictionId} HTTP/1.1
Host: api.hosted.prismlabs.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

{
  "id": "unique-body-shape-prediction-id",
  "status": "PROCESSING",
  "scanId": "unique-scan-id",
  "predictionType": "weight_loss",
  "targetWeight": 50,
  "targetBodyfat": 20,
  "createdAt": "text",
  "updatedAt": "text"
}

Delete a body shape prediction

delete

https://api.hosted.prismlabs.techhttps://sandbox-api.prism.hosted.com

/body-shape-prediction/{bodyShapePredictionId}

This operation deletes a specific body shape prediction. After deletion, the body shape prediction and its associated data are no longer available for retrieval or reporting.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

bodyShapePredictionIdstringRequired

The unique ID of the body shape prediction.

Example: unique-body-shape-prediction-id

Responses

200Success

application/json;v=1

delete

/body-shape-prediction/{bodyShapePredictionId}

HTTPcURLJavaScriptPython

DELETE /body-shape-prediction/{bodyShapePredictionId} HTTP/1.1
Host: api.hosted.prismlabs.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

{
  "id": "unique-body-shape-prediction-id",
  "status": "PROCESSING",
  "scanId": "unique-scan-id",
  "predictionType": "weight_loss",
  "targetWeight": 50,
  "targetBodyfat": 20,
  "createdAt": "text",
  "updatedAt": "text"
}

Get all body shape predictions for a scan

get

https://api.hosted.prismlabs.techhttps://sandbox-api.prism.hosted.com

/scans/{scanId}/body-shape-predictions

This operation returns all body shape predictions associated with a specific scan.

Use this endpoint to list every Future Me prediction that has been created for the scan, for example to show a history of different target scenarios (weight or body fat goals) in your application.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

scanIdstringRequired

The unique ID of the scan.

Example: unique-scan-id

Query parameters

unit-systemstring · enumOptional

The unit system in which values will be returned.

Possible values:

Responses

200Success

application/json;v=1

get

/scans/{scanId}/body-shape-predictions

HTTPcURLJavaScriptPython

GET /scans/{scanId}/body-shape-predictions HTTP/1.1
Host: api.hosted.prismlabs.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

[
  {
    "id": "unique-body-shape-prediction-id",
    "status": "PROCESSING",
    "scanId": "unique-scan-id",
    "predictionType": "weight_loss",
    "targetWeight": 50,
    "targetBodyfat": 20,
    "createdAt": "text",
    "updatedAt": "text"
  }
]