Routes & Descriptions

Get Product By Product Code

Summary

Given a product code, such as 698241110109 from UPC/Barcode scanning, get the detailed information and nutrients of the corresponding food product.

Get Food By Product Code

get

get food by product code

Path parameters

productCodeanyRequired

product code

Query parameters

minQualityScoreanyOptional

minimum quality score

Responses

application/json

objectOptional

application/json

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v2/products/napi/food/productCode/{productCode} HTTP/1.1
Host: api.passiolife.com
Accept: */*

{
  "brandName": "text",
  "branded": {
    "certified": true,
    "country": "text",
    "images": [
      {
        "bucket": "text",
        "path": "text"
      }
    ],
    "ingredients": "text",
    "ocrText": "text",
    "owner": "text",
    "productCode": "text",
    "reviewed": true,
    "tested": true,
    "upc": "text"
  },
  "concerns": [
    1
  ],
  "description": "text",
  "fromViews": [
    "text"
  ],
  "iconId": "text",
  "id": "text",
  "licenseCopy": "text",
  "name": "text",
  "name_i18n": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "nutrients": [
    {
      "amount": 1,
      "id": 1,
      "nutrient": {
        "group": "text",
        "id": 1,
        "name": "text",
        "origin": [
          {
            "dataType": "text",
            "id": "text",
            "source": "text",
            "timestamp": "text"
          }
        ],
        "shortName": "text",
        "unit": "text"
      }
    }
  ],
  "origin": [
    {
      "dataType": "text",
      "id": "text",
      "source": "text",
      "timestamp": "text"
    }
  ],
  "popularity": 1,
  "portions": [
    {
      "name": "text",
      "quantity": 1,
      "suggestedQuantity": [
        1
      ],
      "weight": {
        "unit": "text",
        "value": 1
      }
    }
  ],
  "qualityScore": "text",
  "refCode": "text",
  "tags": [
    "text"
  ],
  "timestamp": "text",
  "webLinks": [
    "text"
  ]
}

Get Product By Food ID

Summary

Given a food items ID, such as 698241110109 get the detailed information and nutrients of the corresponding food product.

Get Food By ID

get

get food record by its corresponding food identifier

Path parameters

externalFoodIdanyRequired

food id (ex: 1599690204479)

Query parameters

metadataanyOptional

client can send additional key/value pair data where keys are strings, and values are some json-serializable type. The data should be JSON-encoded and then base64-URL encoded

Responses

application/json

objectOptional

application/json

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v2/products/napi/food/{externalFoodId} HTTP/1.1
Host: api.passiolife.com
Accept: */*

{
  "brandName": "text",
  "branded": {
    "certified": true,
    "country": "text",
    "images": [
      {
        "bucket": "text",
        "path": "text"
      }
    ],
    "ingredients": "text",
    "ocrText": "text",
    "owner": "text",
    "productCode": "text",
    "reviewed": true,
    "tested": true,
    "upc": "text"
  },
  "concerns": [
    1
  ],
  "description": "text",
  "fromViews": [
    "text"
  ],
  "iconId": "text",
  "id": "text",
  "licenseCopy": "text",
  "name": "text",
  "name_i18n": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "nutrients": [
    {
      "amount": 1,
      "id": 1,
      "nutrient": {
        "group": "text",
        "id": 1,
        "name": "text",
        "origin": [
          {
            "dataType": "text",
            "id": "text",
            "source": "text",
            "timestamp": "text"
          }
        ],
        "shortName": "text",
        "unit": "text"
      }
    }
  ],
  "origin": [
    {
      "dataType": "text",
      "id": "text",
      "source": "text",
      "timestamp": "text"
    }
  ],
  "popularity": 1,
  "portions": [
    {
      "name": "text",
      "quantity": 1,
      "suggestedQuantity": [
        1
      ],
      "weight": {
        "unit": "text",
        "value": 1
      }
    }
  ],
  "qualityScore": "text",
  "refCode": "text",
  "tags": [
    "text"
  ],
  "timestamp": "text",
  "webLinks": [
    "text"
  ]
}

Get Product By Reference Code

Summary

All items returned from our API come with a Reference Code. This can be used to retreive the same item later, and to store custom data if necessary.

Get Search Result Food By RefCode

get

given a search result refcode, retreive the full food information

Path parameters

refCodeanyRequired

the string of a base64 url encoded json str. returned with results as 'refCode' from this api. example decoded object: {\

Query parameters

metadataanyOptional

client can send additional key/value pair data where keys are strings, and values are some json-serializable type. The data should be JSON-encoded and then base64-URL encoded

Responses

application/json

objectOptional

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v2/products/napi/food/search/result/refCode/:refCode HTTP/1.1
Host: api.passiolife.com
Accept: */*

{
  "alternatives": [
    {
      "displayName": "text",
      "iconId": "text",
      "labelId": "text",
      "resultId": "text",
      "type": "text"
    }
  ],
  "results": [
    {
      "displayName": "text",
      "iconId": "text",
      "ingredients": [
        {
          "brandName": "text",
          "branded": {
            "certified": true,
            "country": "text",
            "images": [
              {
                "bucket": "text",
                "path": "text"
              }
            ],
            "ingredients": "text",
            "ocrText": "text",
            "owner": "text",
            "productCode": "text",
            "reviewed": true,
            "tested": true,
            "upc": "text"
          },
          "concerns": [
            1
          ],
          "description": "text",
          "fromViews": [
            "text"
          ],
          "iconId": "text",
          "id": "text",
          "licenseCopy": "text",
          "name": "text",
          "name_i18n": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "nutrients": [
            {
              "amount": 1,
              "id": 1,
              "nutrient": {
                "group": "text",
                "id": 1,
                "name": "text",
                "origin": [
                  {
                    "dataType": "text",
                    "id": "text",
                    "source": "text",
                    "timestamp": "text"
                  }
                ],
                "shortName": "text",
                "unit": "text"
              }
            }
          ],
          "origin": [
            {
              "dataType": "text",
              "id": "text",
              "source": "text",
              "timestamp": "text"
            }
          ],
          "popularity": 1,
          "portions": [
            {
              "name": "text",
              "quantity": 1,
              "suggestedQuantity": [
                1
              ],
              "weight": {
                "unit": "text",
                "value": 1
              }
            }
          ],
          "qualityScore": "text",
          "refCode": "text",
          "tags": [
            "text"
          ],
          "timestamp": "text",
          "webLinks": [
            "text"
          ]
        }
      ],
      "internalId": "text",
      "internalName": "text",
      "portions": [
        {
          "name": "text",
          "quantity": 1,
          "suggestedQuantity": [
            1
          ],
          "weight": {
            "unit": "text",
            "value": 1
          }
        }
      ],
      "refCode": "text",
      "type": "text"
    }
  ]
}

Search Foods

Summary

This route allows text search against our entire database of foods, products, and recipes.

Simply URL Encode your search term to take care of special characters, and send the request! The default limit (max results returned) is 50. This is the recommended setting, but can be adjusted as needed.

Search Foods (Basic)

get

search for food (generic, branded or restaraunt) or recipes

Query parameters

termanyRequired

enter your search term here.

limitanyOptional

sets the maximum number of results to be returned; narrowing, if applied, occurs after this limit.

metadataanyOptional

client can send additional key/value pair data where keys are strings, and values are some json-serializable type. The data should be JSON-encoded and then base64-URL encoded

smartSearchanyOptional

set to true to enable a more intelligent AI than default to sort the results. This mode will cost more tokens when enabled, and be slightly slower to respond.

Responses

application/json

objectOptional

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v2/products/napi/food/search/advanced HTTP/1.1
Host: api.passiolife.com
Accept: */*

{
  "alternateNames": [
    "text"
  ],
  "results": [
    {
      "brandName": "text",
      "displayName": "text",
      "iconId": "text",
      "labelId": "text",
      "longName": "text",
      "nutritionPreview": {
        "calories": 1,
        "carbs": 1,
        "fat": 1,
        "fiber": 1,
        "portion": {
          "name": "text",
          "quantity": 1,
          "suggestedQuantity": [
            1
          ],
          "weight": {
            "unit": "text",
            "value": 1
          }
        },
        "protein": 1
      },
      "recipeId": "text",
      "refCode": "text",
      "referenceId": "text",
      "resultId": "text",
      "score": 1,
      "scoredName": "text",
      "shortName": "text",
      "synonymId": "text",
      "tags": [
        "text"
      ],
      "type": "text"
    }
  ]
}

(Deprecated) Get Search Result Details [use Reference Codes]

Summary

This route remains to support backward compatibility. Reference Codes should be used instead for all new implementations.

• labelId If the selected result has a labelId, pass it as this parameter. If the labelId is empty, pass an all 0's uuid: 00000000-0000-0000-0000-000000000000

• type All search results will have a type field which will be one of synonym, recipe, or reference. Pass this value to the type parameter

• resultId all search results will have a resultId. Pass this value to the resultId parameter

Deprecated

Get Search Result Food

get

given a search result object, retreive the full food information

Path parameters

labelIdanyRequired

labelid from search result. use an all zeros uuid if unknown.

typeanyRequired

type from search result

resultIdanyRequired

resultid from search result

Query parameters

metadataanyOptional

client can send additional key/value pair data where keys are strings, and values are some json-serializable type. The data should be JSON-encoded and then base64-URL encoded

Responses

application/json

objectOptional

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v2/products/napi/food/search/result/:labelId/:type/:resultId HTTP/1.1
Host: api.passiolife.com
Accept: */*

{
  "alternatives": [
    {
      "displayName": "text",
      "iconId": "text",
      "labelId": "text",
      "resultId": "text",
      "type": "text"
    }
  ],
  "results": [
    {
      "displayName": "text",
      "iconId": "text",
      "ingredients": [
        {
          "brandName": "text",
          "branded": {
            "certified": true,
            "country": "text",
            "images": [
              {
                "bucket": "text",
                "path": "text"
              }
            ],
            "ingredients": "text",
            "ocrText": "text",
            "owner": "text",
            "productCode": "text",
            "reviewed": true,
            "tested": true,
            "upc": "text"
          },
          "concerns": [
            1
          ],
          "description": "text",
          "fromViews": [
            "text"
          ],
          "iconId": "text",
          "id": "text",
          "licenseCopy": "text",
          "name": "text",
          "name_i18n": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "nutrients": [
            {
              "amount": 1,
              "id": 1,
              "nutrient": {
                "group": "text",
                "id": 1,
                "name": "text",
                "origin": [
                  {
                    "dataType": "text",
                    "id": "text",
                    "source": "text",
                    "timestamp": "text"
                  }
                ],
                "shortName": "text",
                "unit": "text"
              }
            }
          ],
          "origin": [
            {
              "dataType": "text",
              "id": "text",
              "source": "text",
              "timestamp": "text"
            }
          ],
          "popularity": 1,
          "portions": [
            {
              "name": "text",
              "quantity": 1,
              "suggestedQuantity": [
                1
              ],
              "weight": {
                "unit": "text",
                "value": 1
              }
            }
          ],
          "qualityScore": "text",
          "refCode": "text",
          "tags": [
            "text"
          ],
          "timestamp": "text",
          "webLinks": [
            "text"
          ]
        }
      ],
      "internalId": "text",
      "internalName": "text",
      "portions": [
        {
          "name": "text",
          "quantity": 1,
          "suggestedQuantity": [
            1
          ],
          "weight": {
            "unit": "text",
            "value": 1
          }
        }
      ],
      "refCode": "text",
      "type": "text"
    }
  ]
}