---
title: "Thư viện tài liệu IR"
method: GET
path: "/ir/{symbol}/documents"
tags: ["IREngagement"]
---

# Thư viện tài liệu IR

`GET /ir/{symbol}/documents`

## Request

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

## Path parameters

- `symbol` string, required

## Query parameters

- `category` 1 | 2 | 3 | 4 | 5 | 6
- `status` integer

## Response `200`

OK

- FireAntApiModelsIRIRDocumentItem[]
  - `documentId` integer: ID tài liệu
  - `companyId` integer: ID công ty
  - `category` 1 | 2 | 3 | 4 | 5 | 6: Loại tài liệu (1 = FinancialReport, 2 = AnnualReport, 3 = Presentation, 4 = Governance, 5 = Prospectus, 6 = Other)
  - `title` string: Tiêu đề
  - `period` string: Kỳ báo cáo, ví dụ 2026-Q2
  - `language` string: Ngôn ngữ
  - `fileUrl` string: Đường dẫn tệp
  - `fileName` string: Tên tệp
  - `fileSize` integer: Kích thước tệp
  - `contentType` string: Kiểu nội dung
  - `publishedDate` string, date-time: Thời điểm công bố
  - `downloadCount` integer: Tổng lượt tải - đây là sự kiện đo được thật, khác với lượt xem
  - `downloadsLast30Days` integer: Lượt tải trong 30 ngày
  - `status` integer: Trạng thái: 0 nháp, 1 đã công bố, 2 lưu trữ
  - `uploadedBy` string: Người tải lên
  - `createdDate` string, date-time: Ngày tạo
  - `modifiedBy` string: Người sửa gần nhất
  - `modifiedDate` string, date-time: Thời điểm sửa gần nhất

## Changes

- **2026-09-25** `a481789cd81c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/ir/:symbol/documents/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)