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.

The user endpoints let authenticated clients inspect and modify account information. The /me routes act on the token owner’s own record, making it easy to build profile screens without exposing the caller’s internal user ID. The root GET / route returns all registered users and is intended for admin or household-invitation flows.

​
GET /api/v1/usuarios/me

Returns the full profile of the currently authenticated user. The identity is derived from the Bearer token — no path or query parameters are needed. Authentication: Authorization: Bearer <token> required.

​
Response — 200 OK

​
id_usuario
integer
Unique numeric identifier for the user.
​
nombres
string
First name(s) on file.
​
apellidos
string | null
Last name(s), or null if not set.
​
correo
string
The email address used to authenticate.
​
fecha_registro
string (datetime) | null
ISO 8601 timestamp of account creation.
​
estado
string
Current account status (e.g. "activo", "inactivo").
curl -X GET https://api.fridgeradar.com/api/v1/usuarios/me \
  -H "Authorization: Bearer <token>"
StatusMeaning
200 OKUser profile returned successfully.
401 UnauthorizedToken missing, expired, or invalid.

​
PATCH /api/v1/usuarios/me

Partially updates the authenticated user’s profile. Send only the fields you want to change; omitted fields retain their current values. Authentication: Authorization: Bearer <token> required.
​
nombres
string
Updated first name(s). Optional.
​
apellidos
string
Updated last name(s). Optional.
​
correo
string
New email address. Must be a valid email and unique across all accounts. Optional.
​
password
string
New plain-text password. The service will hash it before saving. Optional.
​
estado
string
Account status override (e.g. "activo", "inactivo"). Optional.

​
Response — 200 OK

Returns the complete updated user object using the same shape as GET /me.
​
id_usuario
integer
Unchanged primary key.
​
nombres
string
First name(s) after the update.
​
apellidos
string | null
Last name(s) after the update.
​
correo
string
Email after the update.
​
fecha_registro
string (datetime) | null
Original registration timestamp — never modified by this endpoint.
​
estado
string
Account status after the update.
curl -X PATCH https://api.fridgeradar.com/api/v1/usuarios/me \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "nombres": "Ana Lucía",
    "correo": "ana.lucia@example.com"
  }'
StatusMeaning
200 OKProfile updated; full updated object returned.
401 UnauthorizedToken missing, expired, or invalid.
409 ConflictThe requested email is already in use by another account.
422 Unprocessable EntityValidation error — e.g. invalid email format.

​
GET /api/v1/usuarios/

Returns an array of all registered user profiles. Useful for resolving user IDs when adding members to a household. Authentication: Authorization: Bearer <token> required.

​
Response — 200 OK

Returns a JSON array where each element follows the UsuarioResponse shape.
​
id_usuario
integer
Unique numeric identifier for the user.
​
nombres
string
First name(s).
​
apellidos
string | null
Last name(s), or null.
​
correo
string
Registered email address.
​
fecha_registro
string (datetime) | null
Account creation timestamp.
​
estado
string
Account status.
curl -X GET https://api.fridgeradar.com/api/v1/usuarios/ \
  -H "Authorization: Bearer <token>"
StatusMeaning
200 OKArray of user objects returned (may be empty).
401 UnauthorizedToken missing, expired, or invalid.

Build docs developers (and LLMs) love

Get started for freeTalk to us