An official API documentation for the Kenko mobile application. All requests include at least one example response and short description. In order to use users-only routes you need to get the JWT token from the login endpoint and then send it with every request in the Authorization header using this format: Authorization: Bearer [jwt] .
In the API you will often find date path parameter. It's a date in YYYY-MM-DD format. For example: 2025-06-23 which translates to June 23rd, 2025.
Creates a new user account. Returns 201 Created if request was successful.
\nLog into the account. Returns 200 OK with JWT token as the response body.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Endpoint for checking whether email or username is already taken by other user. This request takes two query parameters.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Update user avatar, you need to send file using form-data in field called avatar. File needs to be in either image/png or image/jpeg mime type.
Returns full user information with details, preferences and goals. The returned weight and height is automatically converted to user selected unit.
Endpoint to update user details, all fields in the body are optional, tho you have to send at least one or else you will get an error.
\nNOTE: weightLb and weightSt must be sent together if user's preferred weight unit is stones and pounds, same thing applies to heightFt and heightIn
Endpoint to update user preferences, all fields in the body are optional so you can send only ones that need to be updated. At least one field needs to be provided.
\nUpdates user's nutrition goals
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Delete user avatar, resetting to the default one.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Update user's macronutrients (kcal) distribution relative to TDEE. The distribution sum must add up to 100%.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Update user's macronutrients (kcal) distribution relative to TDEE. The distribution sum must add up to 100%.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Search through the products database using custom query, returns an array of products matching the query.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Search query, can be anything including product name, brand and ingredients
\n","type":"text/plain"},"key":"query","value":"kinder"}],"variable":[]}},"response":[{"id":"1f4b6415-9ff1-4600-9472-e4675bd388c8","name":"Products","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://127.0.0.1:3000/products?query=kinder","host":["http://127.0.0.1:3000"],"path":["products"],"query":[{"key":"query","value":"kinder","description":"Search query, can be anything including product name, brand and ingredients"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"vary","value":"origin, access-control-request-method, access-control-request-headers"},{"key":"access-control-allow-credentials","value":"true"},{"key":"content-length","value":"196"},{"key":"date","value":"Thu, 17 Jul 2025 17:31:26 GMT"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"2d232ea7-dac5-415e-a685-a54a7cb0dd93\",\n \"name\": \"Kinder Bueno\",\n \"barcode\": 12345678,\n \"brand\": \"Milka\",\n \"ingredients\": \"aha\",\n \"unit\": \"grams\",\n \"quantity\": 1500,\n \"calories\": 15,\n \"proteins\": 15,\n \"fats\": 15,\n \"carbohydrates\": 15\n }\n]"},{"id":"a4966c01-63c2-48a3-9423-9526fb1cd8d2","name":"Not found","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://127.0.0.1:3000/products?query=macchiato","host":["http://127.0.0.1:3000"],"path":["products"],"query":[{"key":"query","value":"macchiato","description":"Search query, can be anything including product name, brand and ingredients"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"vary","value":"origin, access-control-request-method, access-control-request-headers"},{"key":"access-control-allow-credentials","value":"true"},{"key":"content-length","value":"2"},{"key":"date","value":"Sun, 29 Jun 2025 16:04:27 GMT"}],"cookie":[],"responseTime":null,"body":"[]"}],"_postman_id":"e4371488-49f2-4e2b-8ff1-c06a08ff7996"},{"name":"Find product by barcode","id":"38a2c0e8-fb35-4e21-a703-9ae6cd504117","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://127.0.0.1:3000/products/barcode/12345678","description":"Finds product in the database using provided barcode.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Add product from products database to a section. Quantity is provided in grams.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Quick add meal product to provided user section
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Get user's meal products linked to corresponding sections for specific date. The date must be in YYYY-MM-DD format. For example:
GET /meals/2025-06-23\nReturns user's per section and total macros for specific date
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Delete specified meal product from user's meal day
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Add new meal section to user's layout
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Deletes all user sections and resets it to the default layout returning it.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Get a list of user created sections
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Update section details, all body fields are optional so you can only send values which need to be updated. Index starts from 0.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Delete user section using provided id
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"