> ## Documentation Index > Fetch the complete documentation index at: https://docs.lukittu.com/llms.txt > Use this file to discover all available pages before exploring further. # List License Hardware Identifiers > Retrieve a paginated list of hardware identifiers (HWIDs) associated with a specific license. Includes status calculation based on team timeout settings and filtering options. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/dev/teams/{teamId}/licenses/id/{licenseId}/hwid openapi: 3.0.1 info: title: Lukittu API description: > The Lukittu API provides comprehensive license management and verification services for software products. ## Authentication **Client Endpoints** (`/api/v1/client/*`): No authentication required. These are public endpoints for license verification. **Developer Endpoints** (`/api/v1/dev/*`): Require API key authentication via Bearer token. ## API Types - **Client API**: Used by your software to verify licenses, send heartbeats, and download releases - **Developer API**: Used for programmatic license management from your backend systems ## Rate Limiting All endpoints are rate-limited to prevent abuse. If you exceed the rate limit, you'll receive a 429 status code. ## Response Format All responses follow a consistent format with `data` and `result` objects: ```json { "data": {}, // Response data (null for errors) "result": { "timestamp": "2023-09-15T14:30:00Z", "valid": true, "details": "Human-readable message", "code": "SUCCESS_CODE" // Optional error/success code } } ``` version: 1.0.0 contact: name: Lukittu Community url: https://discord.lukittu.com servers: - url: https://app.lukittu.com description: Production server security: [] tags: - name: Client - Verify description: > Client endpoints for license verification, heartbeat monitoring, and file downloads. These endpoints are used directly by your software applications. - name: Dev - Licenses description: | Developer endpoints for license management operations. These endpoints require API key authentication. - name: Dev - Customers description: | Developer endpoints for customer management operations. These endpoints require API key authentication. - name: Dev - Releases description: | Developer endpoints for release management operations. These endpoints require API key authentication. - name: Dev - Statistics description: | Developer endpoints for retrieving team usage statistics. These endpoints require API key authentication. paths: /api/v1/dev/teams/{teamId}/licenses/id/{licenseId}/hwid: get: tags: - Dev - Licenses summary: List License Hardware Identifiers description: > Retrieve a paginated list of hardware identifiers (HWIDs) associated with a specific license. Includes status calculation based on team timeout settings and filtering options. operationId: listLicenseHwids parameters: - $ref: '#/components/parameters/TeamId' - $ref: '#/components/parameters/LicenseId' - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/PageSize' - name: sortColumn in: query description: Column to sort by required: false schema: type: string enum: - lastSeenAt - createdAt default: lastSeenAt - name: sortDirection in: query description: Sort direction required: false schema: type: string enum: - asc - desc default: desc - name: showForgotten in: query description: Whether to include forgotten hardware identifiers required: false schema: type: boolean default: false responses: '200': description: Hardware identifiers retrieved successfully content: application/json: schema: $ref: '#/components/schemas/HardwareIdentifiersListResponse' example: data: hwids: - id: 789e0123-e89b-12d3-a456-426614174333 identifier: HWID-ABC123-XYZ789 status: active forgotten: false licenseId: 456e7890-e89b-12d3-a456-426614174111 teamId: 123e4567-e89b-12d3-a456-426614174000 lastSeenAt: '2023-09-15T14:25:00Z' createdAt: '2023-09-15T10:00:00Z' updatedAt: '2023-09-15T14:25:00Z' - id: 890e1234-e89b-12d3-a456-426614174444 identifier: HWID-DEF456-UVW012 status: inactive forgotten: false licenseId: 456e7890-e89b-12d3-a456-426614174111 teamId: 123e4567-e89b-12d3-a456-426614174000 lastSeenAt: '2023-09-14T08:00:00Z' createdAt: '2023-09-14T08:00:00Z' updatedAt: '2023-09-14T08:00:00Z' totalResults: 2 hasNextPage: false result: timestamp: '2023-09-15T14:30:00Z' valid: true details: Hardware identifiers retrieved successfully 4XX: $ref: '#/components/responses/StandardError' 5XX: $ref: '#/components/responses/StandardError' security: - bearerAuth: [] components: parameters: TeamId: name: teamId in: path required: true description: >- Your team's UUID. You can find this value in your team's settings on the Lukittu dashboard. schema: $ref: '#/components/schemas/UUID' example: 123e4567-e89b-12d3-a456-426614174000 LicenseId: name: licenseId in: path required: true description: The unique identifier (UUID v4) of the license. schema: $ref: '#/components/schemas/UUID' example: 456e7890-e89b-12d3-a456-426614174111 Page: name: page in: query required: false description: Page number for pagination (1-based) schema: type: integer minimum: 1 default: 1 example: 1 PageSize: name: pageSize in: query required: false description: Number of items per page schema: type: integer enum: - 10 - 25 - 50 - 100 default: 25 example: 25 schemas: HardwareIdentifiersListResponse: allOf: - $ref: '#/components/schemas/SuccessResponse' - type: object properties: data: type: object properties: hwids: type: array items: $ref: '#/components/schemas/HardwareIdentifierData' totalResults: type: integer description: Total number of hardware identifiers hasNextPage: type: boolean description: Whether there are more results available required: - hwids - totalResults - hasNextPage UUID: type: string format: uuid description: UUID v4 identifier SuccessResponse: type: object properties: data: type: object description: Response data result: allOf: - $ref: '#/components/schemas/StandardResult' - type: object properties: valid: type: boolean enum: - true description: Always true for success responses required: - data - result HardwareIdentifierData: type: object properties: id: $ref: '#/components/schemas/UUID' description: Hardware identifier ID identifier: type: string description: The hardware identifier string status: $ref: '#/components/schemas/HwidStatus' forgotten: type: boolean description: Whether this HWID has been marked as forgotten licenseId: $ref: '#/components/schemas/UUID' teamId: $ref: '#/components/schemas/UUID' lastSeenAt: type: string format: date-time description: When this HWID was last seen createdAt: type: string format: date-time description: When this HWID was first created updatedAt: type: string format: date-time description: When this HWID was last updated required: - id - identifier - status - forgotten - licenseId - teamId - lastSeenAt - createdAt - updatedAt ErrorResponse: type: object properties: data: type: object description: Additional error-related data nullable: true result: allOf: - $ref: '#/components/schemas/StandardResult' - type: object properties: valid: type: boolean enum: - false description: Always false for error responses code: type: string description: Error code indicating the specific issue enum: - INTERNAL_SERVER_ERROR - BAD_REQUEST - LICENSE_NOT_FOUND - IP_LIMIT_REACHED - HWID_LIMIT_REACHED - PRODUCT_NOT_FOUND - CUSTOMER_NOT_FOUND - LICENSE_EXPIRED - LICENSE_SUSPENDED - TEAM_NOT_FOUND - RATE_LIMIT - HARDWARE_IDENTIFIER_BLACKLISTED - COUNTRY_BLACKLISTED - IP_BLACKLISTED - RELEASE_NOT_FOUND - FORBIDDEN - UNAUTHORIZED - INVALID_SESSION_KEY - NO_ACCESS_TO_RELEASE - RELEASE_ARCHIVED - RELEASE_DRAFT required: - code required: - result StandardResult: type: object properties: timestamp: type: string format: date-time description: Timestamp when the response was generated valid: type: boolean description: Indicates whether the operation was successful details: type: string description: Human-readable description of the result required: - timestamp - valid - details HwidStatus: type: string enum: - active - inactive - forgotten description: Current status of the hardware identifier responses: StandardError: description: > Standard API error response. All errors follow the same `{data, result}` structure. The HTTP status code indicates the general error category, while `result.code` provides specific error details. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: apiKey description: > API key authentication for development endpoints. You can create API keys in your team's settings on the Lukittu dashboard. Include the API key in the Authorization header as: `Bearer YOUR_API_KEY` Example: ``` Authorization: Bearer lukittu_api_key_abc123def456... ``` ````