---
title: "Danh sách công ty sử dụng dịch vụ"
method: GET
path: "/admin/ir/companies"
tags: ["IRAdmin"]
---

# Danh sách công ty sử dụng dịch vụ

`GET /admin/ir/companies`

## Request

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

## Query parameters

- `status` 0 | 1 | 2 | 3
- `keyword` string
- `includeDeleted` boolean
- `offset` integer
- `limit` integer

## Response `200`

OK

- FireAntApiModelsIRIRPagedResultFireAntApiModelsIRIRCompanyItem: Kết quả phân trang dùng chung cho module IR
  - `items` FireAntApiModelsIRIRCompanyItem[]: Danh sách bản ghi của trang hiện tại
    - `companyId` integer: ID công ty trong hệ thống IR
    - `symbol` string: Mã chứng khoán
    - `companyName` string: Tên đầy đủ
    - `shortName` string: Tên viết tắt
    - `exchange` string: Sàn niêm yết
    - `logoUrl` string: Logo
    - `website` string: Website công ty
    - `irWebsite` string: Trang quan hệ nhà đầu tư
    - `status` 0 | 1 | 2 | 3: Trạng thái sử dụng dịch vụ (0 = Pending, 1 = Active, 2 = Suspended, 3 = Closed)
    - `contactName` string: Người liên hệ phụ trách IR
    - `contactEmail` string: Email liên hệ
    - `contactPhone` string: Điện thoại liên hệ
    - `role` 1 | 2 | 3 | 4 | 5: Vai trò của người dùng hiện tại trong công ty này (1 = Owner, 2 = Admin, 3 = Editor, 4 = Analyst, 5 = Viewer)
    - `planCode` string: Mã gói dịch vụ đang dùng
    - `planName` string: Tên gói dịch vụ
    - `subscriptionStatus` 0 | 1 | 2 | 3: Trạng thái hợp đồng (0 = Draft, 1 = Active, 2 = Expired, 3 = Cancelled)
    - `subscriptionStartDate` string, date-time: Ngày bắt đầu hợp đồng
    - `subscriptionEndDate` string, date-time: Ngày kết thúc hợp đồng
    - `daysRemaining` integer: Số ngày còn lại của hợp đồng
    - `oaUserName` string: Tài khoản Official Account
    - `oaStatus` 0 | 1 | 2 | 3: Trạng thái Official Account (0 = Requested, 1 = Verified, 2 = Rejected, 3 = Revoked)
    - `oaDisplayName` string: Tên hiển thị của Official Account
    - `userCount` integer: Số người dùng đang hoạt động
    - `openTicketCount` integer: Số yêu cầu hỗ trợ đang mở
    - `isDeleted` boolean: Đã xóa mềm
    - `onboardedDate` string, date-time: Ngày bắt đầu sử dụng
    - `createdDate` string, date-time: Ngày tạo
    - `features` object: Hạn mức theo gói: khóa tính năng và giới hạn (null = không giới hạn)
  - `totalCount` 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 mỗi trang

## Changes

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

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