---
updatedAt: 2026-10-07T02:03:02.000Z
agentTools:
  projectIndex: https://docs.logmeal.com/llms.txt
---

# How To Use the Food AI Engine API Reference

This section helps you quickly understand how to authenticate, respect limits, and navigate the available Food AI Engine API plans.

Welcome to the **Food AI Engine API Reference**. This section provides a factual, endpoint-by-endpoint description of the Food AI Engine API, based directly on our OpenAPI specification.

An API is a simple way for your app to talk to LogMeal over the internet—your app sends a request (e.g., an image), and the API returns structured results in json format (e.g., recognized foods and nutrition).

If you’re new to LogMeal, we recommend starting with the **[Quickstart](https://docs.logmeal.com/docs/guides-getting-started-quickstart#/)** section. Once you’ve completed your first successful request, come back here to explore every endpoint in detail.

***

## Base URL

All API requests are made to the following base URL:

```commandline
https://api.logmeal.com/v2
```

***

## Authentication

The Food AI Engine API uses **Bearer Tokens** for authentication. Each request must include an `Authorization` header with the correct <Glossary>token</Glossary> type:

```commandline
Authorization: Bearer YOUR_TOKEN
```

* ⚫ **<Glossary>APICompany</Glossary> <Glossary>token</Glossary>** – used for company-level management (creating APIUsers, assigning plans, etc.)
* 🔴 **<Glossary>APIUser</Glossary> <Glossary>token</Glossary>** – used by end-users of your app for logging meals and fetching nutritional info
* 🔵 **<Glossary>APIUserManager</Glossary> <Glossary>token</Glossary>** – used by managers/clinicians to access multiple users’ histories

👉 For more details, see **[User Types & Access Tokens](https://docs.logmeal.com/docs/guides-essential-concepts-users-and-access-tokens)**.

***

## <Glossary>Rate Limit</Glossary>s & Quotas

Some endpoints are limited by:

* **Monthly <Glossary>credits</Glossary>** (<span style={{color: "red", fontSize: "1.8em", fontWeight: "bold"}}>©</span> icon)
* **<Glossary>Daily request limits</Glossary>** (<span style={{color: "orange", fontSize: "1.2em", fontWeight: "bold"}}>(D)</span> icon)
* **<Glossary>Per‑second request limits</Glossary>** (<span style={{color: "purple", fontSize: "1.2em", fontWeight: "bold"}}>(S)</span> icon)

The endpoints that have some type of limitation are indicated with the icon ⏱.
You’ll find the relevant limits listed in each endpoint description. For a complete overview, see **[Plans & Limits](https://docs.logmeal.com/docs/guides-essential-concepts-plans-limits)**.

***

## Plan Subscription Limits

Depending on your **subscription plan**, you may have access to different sets of endpoints:

* <span style={{color:"#FFC933", fontWeight:"bold"}}><Glossary>Analyse</Glossary></span>: Essential food <Glossary>recognition</Glossary>, ingredients, and nutritional extraction.

* <span style={{color:"#6FB3E7", fontWeight:"bold"}}><Glossary>Monitor</Glossary></span>: Extended monitoring features: <Glossary>history</Glossary>, <Glossary>goal</Glossary>s, custom <Glossary>occasions</Glossary>, and more.

* <span style={{color:"#7EDC7B", fontWeight:"bold"}}><Glossary>Recommend</Glossary></span>: Advanced AI features: Nutri-Scores, recommendations, food <Glossary>quantity detection</Glossary>, food <Glossary>waste detection</Glossary>.

* <span style={{color:"#F08A05", fontWeight:"bold"}}><Glossary>Custom</Glossary></span>: Enterprise or custom integrations tailored to your needs.

**If you are using our free time-limited trial plan you will have temporary access to ALL endpoints.**

👉 See the full **[Plans & Limits](https://docs.logmeal.com/docs/guides-essential-concepts-plans-limits)** guide for detailed access by feature.

***

## Error Handling

The API returns standard HTTP status codes:

* **200 OK** – Request succeeded
* **400 Bad Request** – Invalid input
* **401 Unauthorized** – Missing or invalid <Glossary>token</Glossary>
* **403 Forbidden** – <Glossary>Token</Glossary> does not have access rights
* **404 Not Found** – Resource does not exist
* **429 Too Many Requests** – <Glossary>Rate limit</Glossary> exceeded
* **500 Internal Server Error** – Something went wrong on our end

For troubleshooting tips, see **[Guides > Essential Concepts > Best Practices > Troubleshooting](https://docs.logmeal.com/docs/guides-best-practices-toubleshooting#/-troubleshooting)**.

***

## Next Steps

* Explore the full list of API Endpoints
* Review available [Features](https://docs.logmeal.com/docs/guides-features-overview#/)