List all API keys in entity (Admin)

​

Get all API keys for all users within the current entity. Requires api-keys:self permission.

Supports pagination, sorting, searching, and filtering.

Searchable fields: name, userEmail, userName Filterable fields: userId, enabled, roleId Sortable fields: createdAt, name, expiresAt, lastUsedAt, enabled, userName, userEmail

Query Parameters
  • page
    Type: integer
    min:  
    1

    Page number (1-indexed, default: 1)

  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Items per page (max: 100; default varies by endpoint)

  • sort
    Type: string

    Sort field and direction. Supports comma-separated values for multi-column sorting. Available fields: createdAt, name, expiresAt, lastUsedAt, enabled, userName, userEmail

  • search
    Type: string

    Search term to filter by name, userEmail, or userName

  • userId
    Type: stringFormat: uuid

    Filter by user ID

  • enabled
    Type: boolean

    Filter by enabled status (true/false)

  • roleId
    Type: stringFormat: uuid

    Filter by role ID

Responses
  • application/json
  • application/json
  • application/json
Request Example for get/auth/api-keys
curl 'https://api.gpcn.com/v1/auth/api-keys?page=1&limit=1&sort=createdAt%3Adesc&search=&userId=&enabled=true&roleId=' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "success": true,
  "data": [
    {
      "id": "string",
      "name": "string",
      "prefix": "string",
      "start": "string",
      "enabled": true,
      "createdAt": "2026-05-19T14:02:02.487Z",
      "expiresAt": "2026-05-19T14:02:02.487Z",
      "lastUsedAt": "2026-05-19T14:02:02.487Z",
      "roleId": "123e4567-e89b-12d3-a456-426614174000",
      "isInherited": true,
      "roles": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "string",
          "displayName": "string",
          "sortOrder": 1
        }
      ],
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "rateLimitEnabled": true,
      "rateLimitMax": 1,
      "rateLimitWindow": 1,
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "userName": "string",
      "userEmail": "hello@example.com"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "pageSize": 1,
    "totalPages": 1,
    "hasNextPage": true,
    "hasPreviousPage": true
  }
}

API keys retrieved successfully