Skip to main content

Profile

Get the authenticated user’s profile, permission level, and Cisco user info.
GET /api/v1/me
Authorization: Bearer <token>
{
  "success": true,
  "message": "Authenticated user",
  "data": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "first_name": "Admin",
    "last_name": "User",
    "username": "admin",
    "email": "admin@example.com",
    "phone": null,
    "lang": "en",
    "location": null,
    "nationality": null,
    "timezone": "UTC",
    "last_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "last_login_ip": "::1",
    "last_login_at": "2026-06-28T12:00:00.000Z",
    "last_logout_ip": null,
    "is_active": true,
    "created_at": "2026-06-28T12:00:00.000Z",
    "created_by": null,
    "updated_at": "2026-06-28T12:00:00.000Z",
    "created_ip": "::1",
    "updated_ip": "::1",
    "permission": {
      "level": 0,
      "perm_name": "superadmin"
    },
    "cisco_user": {
      "uuid": "550e8400-e29b-41d4-a716-446655441111",
      "user_uuid": "550e8400-e29b-41d4-a716-446655440000",
      "pin_code": "$2b$10$...",
      "created_at": "2026-06-28T12:00:00.000Z"
    }
  },
  "metadata": {}
}

Phones

List all phones enriched with Cisco flags and key expansion modules.
GET /api/v1/me/phones
Authorization: Bearer <token>
{
  "success": true,
  "message": "5 phone(s) found",
  "data": [
    {
      "mac": "AA:BB:CC:DD:EE:01",
      "brand": "Cisco",
      "model": "8845",
      "description": null,
      "name": "Office Phone",
      "hostname": null,
      "location": "Floor 1",
      "phone_ip": "10.0.0.10",
      "phone_vlan": "100",
      "software_version": "14.2",
      "software_type": null,
      "is_active": true,
      "created_at": "2026-06-28T12:00:00.000Z",
      "is_cisco": true,
      "cisco": { "mac": "AA:BB:CC:DD:EE:01", "cisco": true },
      "key_expansion_modules": [
        {
          "uuid": "550e8400-e29b-41d4-a716-446655442222",
          "model": "KEM-8800",
          "mac": null,
          "ip": "10.0.0.11",
          "connected_phone": "AA:BB:CC:DD:EE:01",
          "software_version": "1.0",
          "software_type": null,
          "created_at": "2026-06-28T12:00:00.000Z"
        }
      ]
    }
  ],
  "metadata": {}
}

Cisco Services — Personal Directory

Get the authenticated user’s personal directory contacts.
GET /api/v1/me/cisco-services/personal
Authorization: Bearer <token>
{
  "success": true,
  "message": "2 personal contact(s) found",
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655443333",
      "user_uuid": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Jane Doe",
      "work": "+351911111111",
      "mobile": "+351922222222",
      "home": null,
      "email": "jane@example.com",
      "ringtone": null,
      "created_at": "2026-06-28T12:00:00.000Z"
    }
  ],
  "metadata": {}
}

Cisco Services — Company Directory

Get the company-wide directory contacts.
GET /api/v1/me/cisco-services/company
Authorization: Bearer <token>
{
  "success": true,
  "message": "10 company contact(s) found",
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655444444",
      "name": "Company Reception",
      "work": "+351900000000",
      "mobile": null,
      "home": null,
      "email": "reception@company.com",
      "ringtone": null,
      "department": "Administration",
      "company": "Cisisk",
      "location": "Lisbon",
      "building": "HQ",
      "is_active": true,
      "created_at": "2026-06-28T12:00:00.000Z"
    }
  ],
  "metadata": {}
}