---
title: "Mẫu của tôi thuộc một ứng dụng (mọi chế độ chia sẻ, mới cập nhật trước)"
method: GET
path: "/me/excel/templates"
tags: ["MyExcelTemplates"]
---

# Mẫu của tôi thuộc một ứng dụng (mọi chế độ chia sẻ, mới cập nhật trước)

`GET /me/excel/templates`

## Request

- Base URL: `https://api.fireant.vn`
- URL: `https://api.fireant.vn/me/excel/templates`
- Auth: OAuth 2
  - Implicit: `https://accounts.fireant.vn/connect/authorize`
  - Scopes: `user-data-read`
- TypeScript: <https://skmtc.dev/fireant/apis/fireant-restful-api/docs/me/excel/templates/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `app` string
- `q` string
- `visibility` 0 | 1 | 2
- `offset` integer
- `limit` integer

## Response `200`

Thành công

- FireAntApiModelsExcelTemplatesExcelTemplatePagedResultFireAntApiModelsExcelTemplatesExcelTemplateItem: Kết quả phân trang của module Mẫu Excel
  - `total` integer: Tổng số bản ghi thỏa điều kiện
  - `offset` integer: Vị trí bản ghi đầu tiên
  - `limit` integer: Số bản ghi tối đa của trang
  - `items` FireAntApiModelsExcelTemplatesExcelTemplateItem[]: Danh sách phần tử của trang hiện tại
    - `templateId` integer: ID mẫu
    - `name` string: Tên mẫu
    - `description` string: Mô tả
    - `categoryCode` string: Mã danh mục (market, financials, valuation...)
    - `categoryName` string: Tên danh mục
    - `tags` string[]: Tag (chữ thường)
    - `ownerUserName` string: Tên đăng nhập của chủ sở hữu
    - `ownerName` string: Tên hiển thị của chủ sở hữu (null nếu không tra được)
    - `ownerAvatar` string: URL ảnh đại diện của chủ sở hữu (null nếu không tra được)
    - `visibility` 0 | 1 | 2: Chế độ chia sẻ: 0 Private, 1 Link, 2 Public (0 = Private, 1 = Link, 2 = Public)
    - `reviewStatus` 0 | 1 | 2 | 3: Trạng thái duyệt: 0 None, 1 Pending, 2 Approved, 3 Rejected (0 = None, 1 = Pending, 2 = Approved, 3 = Rejected)
    - `isOfficial` boolean: Mẫu chính thức do FireAnt phát hành (luôn hiện trong thư viện)
    - `isFeatured` boolean: Mẫu nổi bật
    - `minMembershipLevel` integer: Hạng thành viên tối thiểu để dùng mẫu: 0 Free, 1 Basic, 2 Pro, 3 Premium
    - `thumbnailUrl` string: URL ảnh xem trước (công khai)
    - `fileFormat` string: Định dạng tệp = đuôi tệp: xlsx, xltx, docx, dotx, pptx, potx
    - `app` string: Ứng dụng của mẫu (suy ra từ fileFormat): excel | word | powerpoint
    - `fileSize` integer: Kích thước tệp (byte)
    - `version` integer: Phiên bản tệp hiện tại (tăng mỗi lần thay tệp)
    - `functions` string[]: Các hàm FireAnt dùng trong mẫu (FA.QUOTE, FA.RATIO...)
    - `sheetNames` string[]: Tên các sheet trong mẫu
    - `language` string: Ngôn ngữ của mẫu (vi, en...)
    - `usageCount` integer: Số lượt sử dụng
    - `likeCount` integer: Số lượt thích
    - `isLiked` boolean: Người dùng hiện tại đã thích mẫu (false khi chưa đăng nhập)
    - `isOwner` boolean: Người dùng hiện tại là chủ sở hữu (false khi chưa đăng nhập)
    - `createdDate` string, date-time: Ngày tạo
    - `updatedDate` string, date-time: Ngày cập nhật cuối
    - `publishedDate` string, date-time: Ngày phát hành (lần đầu được duyệt / phát hành chính thức)

## Other responses

- `400`: Tham số không hợp lệ

## Changes

- **2026-10-10** `300cfd8b632c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/me/excel/templates/get.md)

---

[API](https://skmtc.dev/fireant/apis/fireant-restful-api.md) - [All operations](https://skmtc.dev/fireant/apis/fireant-restful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireant/apis/fireant-restful-api/revisions/c9b3aa855f95?raw)
