Skip to main content

​
GET /api/permissions

Retrieves a complete list of all permissions registered in the authorization system.

​
Authentication

This endpoint requires authentication with a valid Bearer token.

​
Response

Returns an array of permission objects.
​
[]
array
Array of permission objects
​
id
uuid
Unique identifier of the permission
​
name
string
The name of the permission
​
description
string
Description of the permission
​
status
string
Current status of the permission (e.g., “ACTIVE”, “INACTIVE”)

​
Status Codes

  • 200 OK - List retrieved successfully
  • 500 Internal Server Error - Server error occurred

​
Example Request

curl -X GET https://api.example.com/api/permissions \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Example Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "users:read",
    "description": "Permission to read user data",
    "status": "ACTIVE"
  },
  {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "name": "users:write",
    "description": "Permission to create and update user data",
    "status": "ACTIVE"
  },
  {
    "id": "770e8400-e29b-41d4-a716-446655440002",
    "name": "users:delete",
    "description": "Permission to delete user data",
    "status": "INACTIVE"
  }
]

​
Error Response

{
  "timestamp": "2026-03-04T10:30:00Z",
  "status": 500,
  "error": "Internal Server Error",
  "message": "Error interno",
  "path": "/api/permissions"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us