Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/EstefanoARG/FridgeRadar/llms.txt

Use this file to discover all available pages before exploring further.

Alerts are generated automatically by FridgeRadar whenever inventory items approach or pass their expiry date. Each alert belongs to the authenticated user and may be linked to a specific inventory entry. These endpoints let you list, inspect, acknowledge, count, and delete alerts. All routes require a valid Bearer token — responses are scoped to current_user automatically.

​
List Alerts

​
solo_no_leidas
boolean
default:"false"
When true, only unread alerts are returned. Omit or set to false to retrieve all alerts regardless of read status.
curl -X GET "https://api.fridgeradar.app/api/v1/alertas?solo_no_leidas=true" \
  -H "Authorization: Bearer <token>"
Response fields — AlertaResponse
​
id_alerta
integer
required
Unique identifier for the alert.
​
id_usuario
integer
required
ID of the user who owns this alert.
​
id_inventario
integer | null
ID of the inventory item that triggered the alert, or null if the alert is not linked to a specific item.
​
titulo
string
required
Short headline for the alert (e.g. "Leche próxima a vencer").
​
mensaje
string
required
Full descriptive message explaining the alert.
​
tipo
string
required
Alert category such as expiracion_proxima or producto_vencido.
​
leida
boolean
required
true if the user has acknowledged the alert, false otherwise.
​
fecha_alerta
string (datetime)
required
ISO 8601 timestamp indicating when the alert was created.

​
Count Unread Alerts

Returns a lightweight count of how many alerts have not yet been read. Useful for notification badges without fetching the full alert list. 
curl -X GET "https://api.fridgeradar.app/api/v1/alertas/contar" \
  -H "Authorization: Bearer <token>"
​
no_leidas
integer
required
Total number of unread alerts for the authenticated user.

​
Get One Alert

Fetches a single alert by its ID. The service validates that the alert belongs to the authenticated user.
​
id_alerta
integer
required
The unique identifier of the alert to retrieve.
curl -X GET "https://api.fridgeradar.app/api/v1/alertas/42" \
  -H "Authorization: Bearer <token>"

​
Mark Alert as Read

Sets leida = true on the specified alert, acknowledging it on behalf of the authenticated user. Returns the updated AlertaResponse.
​
id_alerta
integer
required
The unique identifier of the alert to mark as read.
curl -X PATCH "https://api.fridgeradar.app/api/v1/alertas/42" \
  -H "Authorization: Bearer <token>"

​
Delete Alert

Permanently removes an alert. Returns 204 No Content on success. The service verifies ownership before deletion.
​
id_alerta
integer
required
The unique identifier of the alert to delete.
curl -X DELETE "https://api.fridgeradar.app/api/v1/alertas/42" \
  -H "Authorization: Bearer <token>"

Build docs developers (and LLMs) love

Get started for freeTalk to us