---
title: "Get User Templates"
method: GET
path: "/api/user_templates"
tags: ["User Template"]
---

# Get User Templates

`GET /api/user_templates`

Get a list of User Templates with optional pagination

## Query parameters

- `ids` integer[], nullable
- `offset` integer, nullable
- `limit` integer, nullable

## Response `200`

Successful Response

- UserTemplateResponse[]
  - `name` string, nullable
  - `data_limit` integer, nullable — data_limit can be 0 or greater
  - `hwid_limit` integer, nullable
  - `expire_duration` integer, nullable — expire_duration can be 0 or greater in seconds
  - `username_prefix` string, nullable
  - `username_suffix` string, nullable
  - `group_ids` integer[], required
  - `extra_settings` ExtraSettings
    - `method` 'aes-128-gcm' | 'aes-256-gcm' | 'chacha20-ietf-poly1305' | 'xchacha20-poly1305'
  - `status` 'active' | 'on_hold'
  - `reset_usages` boolean, nullable
  - `on_hold_timeout` integer, nullable
  - `data_limit_reset_strategy` 'no_reset' | 'day' | 'week' | 'month' | 'year'
  - `is_disabled` boolean, nullable
  - `id` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/rain/apis/pasarguardapi.md) · [All operations](https://skmtc.dev/rain/apis/pasarguardapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rain/pasarguardapi/revisions/b3bebca20611/schema)