Skip to main content
GET
/
api
/
autenticacion
/
perfil
Obtener Perfil
curl --request GET \
  --url https://api.example.com/api/autenticacion/perfil \
  --header 'Authorization: <authorization>'
{
  "200": {},
  "401": {},
  "estado": "<string>",
  "data": {
    "id": 123,
    "name": "<string>",
    "email": "<string>",
    "email_verified_at": {},
    "created_at": "<string>",
    "updated_at": "<string>"
  },
  "roles_asignados": [
    {}
  ]
}

​
Endpoint

GET /api/autenticacion/perfil
Este endpoint permite obtener la información completa del usuario actualmente autenticado, incluyendo sus roles asignados. Es una ruta protegida que requiere un token de autenticación válido.

​
Authentication

​
Authorization
string
required
Token de autenticación Bearer obtenido del endpoint de inicio de sesión.Formato: Bearer {token}Ejemplo: Bearer 1|a8K9mN3vR7xY2qW5eT4pL6jH8dF1sA0cX9bV7nM3

​
Response

​
estado
string
Estado de la operación. Valor: "exito"
​
data
object
Objeto completo del usuario autenticado con todos sus atributos
​
id
integer
ID único del usuario
​
name
string
Nombre completo del usuario
​
email
string
Dirección de correo electrónico del usuario
​
email_verified_at
string|null
Fecha y hora de verificación del correo electrónico (formato ISO 8601)
​
created_at
string
Fecha y hora de creación del usuario (formato ISO 8601)
​
updated_at
string
Fecha y hora de última actualización del usuario (formato ISO 8601)
​
roles_asignados
array
Lista de roles asignados al usuario (ej: ["admin"], ["tecnico", "supervisor"], ["reporter"])

​
Status Codes

​
200
Success
Perfil obtenido exitosamente. Se devuelve la información completa del usuario autenticado.
​
401
Unauthorized
Token de autenticación inválido, expirado o no proporcionado.

​
Examples

​
Successful Request

cURL
curl -X GET http://127.0.0.1:8000/api/autenticacion/perfil \
  -H "Authorization: Bearer 1|a8K9mN3vR7xY2qW5eT4pL6jH8dF1sA0cX9bV7nM3" \
  -H "Accept: application/json"
Response (200 OK) 
{
  "estado": "exito",
  "data": {
    "id": 1,
    "name": "Admin User",
    "email": "[email protected]",
    "email_verified_at": null,
    "created_at": "2026-03-01T10:30:00.000000Z",
    "updated_at": "2026-03-01T10:30:00.000000Z"
  },
  "roles_asignados": ["admin"]
}

​
Unauthorized - Missing Token

cURL
curl -X GET http://127.0.0.1:8000/api/autenticacion/perfil \
  -H "Accept: application/json"
Response (401 Unauthorized) 
{
  "message": "Unauthenticated."
}

​
Unauthorized - Invalid Token

cURL
curl -X GET http://127.0.0.1:8000/api/autenticacion/perfil \
  -H "Authorization: Bearer invalid-token-123" \
  -H "Accept: application/json"
Response (401 Unauthorized) 
{
  "message": "Unauthenticated."
}

​
Example with Technician Role

cURL
curl -X GET http://127.0.0.1:8000/api/autenticacion/perfil \
  -H "Authorization: Bearer 2|xY9wK3mL7vN2qR5tE4pW6jA8dS1fH0cZ9bG7nV3" \
  -H "Accept: application/json"
Response (200 OK) 
{
  "estado": "exito",
  "data": {
    "id": 2,
    "name": "Técnico User",
    "email": "[email protected]",
    "email_verified_at": null,
    "created_at": "2026-03-02T14:20:00.000000Z",
    "updated_at": "2026-03-02T14:20:00.000000Z"
  },
  "roles_asignados": ["tecnico"]
}

​
Notes

  • Este endpoint requiere el middleware auth:sanctum para validar el token de autenticación.
  • El token debe ser enviado en el header Authorization con el formato Bearer {token}.
  • La información del usuario se obtiene directamente del token de autenticación, por lo que siempre devuelve el perfil del usuario que realizó la solicitud.
  • Los roles asignados se obtienen mediante el método getRoleNames() del modelo User, que utiliza el paquete Spatie Laravel Permission.

Build docs developers (and LLMs) love

Get started for freeTalk to us