Skip to main content
Authentication is not required for this endpoint. Results are drawn from public profile data.

​
Query parameters

​
busqueda
string
Case-insensitive search string matched against the nombre field using a partial (contains) match. When omitted, the endpoint returns up to 20 profiles (no specific order guaranteed).

​
Response fields

Returns a JSON array. Each element contains the following fields.
​
id
string
required
UUID of the user profile.
​
nombre
string
required
Display name of the user.
​
avatar_url
string
URL of the user’s avatar image. May be null if not set.
​
sobre_mi
string
Short bio written by the user. May be null if not set.

​
Examples

curl --request GET \
  --url 'https://yourdomain.com/api/usuarios'

​
200 — success (no search term)

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "nombre": "María García",
    "avatar_url": "https://example.com/avatars/maria.png",
    "sobre_mi": "Amante de la cocina tradicional."
  },
  {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "nombre": "Carlos López",
    "avatar_url": null,
    "sobre_mi": null
  }
]

​
400 — database error

{
  "error": "<database error message>"
}

​
500 — internal server error

{
  "error": "Error interno del servidor"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us