---
title: "Fetch keys with filtering and pagination"
method: GET
path: "/keys"
tags: ["Keys"]
---

# Fetch keys with filtering and pagination

`GET /keys`

## Query parameters

- `page` integer
- `limit` integer
- `discord_id` string
- `key` string
- `hwid` string
- `service_id` integer
- `provider_id` integer
- `folder_id` integer
- `status` 'active' | 'used' | 'expired' | 'invalidated'
- `expires_before` string, date-time
- `expires_after` string, date-time

## Response `200`

List of keys

- object
  - `keys` Key[]
    - `id` integer
    - `key_value` string
    - `user_id` integer
    - `service_id` integer, nullable
    - `provider_id` integer
    - `folder_id` integer, nullable
    - `expires_at` string, date-time, nullable
    - `used_at` string, date-time, nullable
    - `is_premium` boolean
    - `is_invalidated` boolean
    - `one_time_use` boolean
    - `expiry_on_first_use` boolean
    - `validity_minutes` integer, nullable — null for forever
    - `no_hwid` boolean
    - `key_name` string, nullable
    - `hwid_limit` integer, nullable — 0 or null for unlimited
    - `max_sessions` integer, nullable — Max concurrent heartbeat sessions (null = inherit provider, 0 = unlimited override)
    - `discord_id` string, nullable
    - `created_at` string, date-time
    - `service_name` string, nullable
    - `provider_name` string, nullable
    - `folder_name` string, nullable
    - `hwids` HWID[]
      - `hwid` string
      - `executor_user_id` string, nullable
      - `bound_at` string, date-time
      - `bound_by` string — How HWID was bound (api, verify, manual, admin)
    - `keys_hwid` string[] — Simple array of HWID strings (convenience field)
  - `pagination` Pagination
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer

---

[API](https://skmtc.net/jnkie/apis/junkie-key-system-rest-api-v2.md) · [All operations](https://skmtc.net/jnkie/apis/junkie-key-system-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jnkie/junkie-key-system-rest-api-v2/versions/1ff91682e5d9/schema)