Evaluate meals and return the macro distribution.

POST

/evaluate/macro-distribution

Evaluates a list of meals on the macro distribution.

Authorizations

• ApiKeyAuth

Parameters

Header Parameters

X-Context-ID

string

Optional pseudonymous end-user context ID for future analytics and request correlation. Must not contain personal data.

Request Body

List of meals to evaluate

Media typeapplication/json

Array<object>

object

entries

required

Array<object>

object

amount

number

Example

12345

food_id

required

string

Example

example_id

unit

required

string

Allowed values: µg mg g kg ml l

Example

g

weighted_before_process

Was it weighed before processing (raw)?

boolean

Responses

200

Evaluation results

Media typeapplication/json

object

breakdown

Array<object>

object

label

string

nutrient

string

Allowed values: carbohydrates protein fat alcohol

percent

number

total_kcal

number

Example

{
  "breakdown": [
    {
      "nutrient": "carbohydrates"
    }
  ]
}

Headers

X-RateLimit-Limit

integer

Maximum requests per minute

X-RateLimit-Remaining

integer

Requests remaining in current window

X-RateLimit-Reset

integer

Unix timestamp when rate limit resets

X-RateLimit-Used

integer

Requests used in current window

400

Validation Error or unknown food

Media typeapplication/json

object

error

object

code

string

details

message

string

Example^generated

{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

401

Unauthorized

Media typeapplication/json

object

error

object

code

string

details

message

string

Example^generated

{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

429

Rate limit exceeded

Media typeapplication/json

object

error

object

code

string

details

message

string

Example^generated

{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

Headers

X-RateLimit-Limit

integer

Maximum requests per minute

X-RateLimit-Remaining

integer

Requests remaining in current window

X-RateLimit-Reset

integer

Unix timestamp when rate limit resets

X-RateLimit-Used

integer

Requests used in current window

X-Retry-After

integer

Seconds to wait before retrying

500

Internal Server Error

Media typeapplication/json

object

error

object

code

string

details

message

string

Example^generated

{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}