---
title: "Chạy báo cáo ngay cho một kỳ"
method: POST
path: "/ir/{symbol}/reports/run"
tags: ["IREngagement"]
---

# Chạy báo cáo ngay cho một kỳ

`POST /ir/{symbol}/reports/run`

## Request

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

## Path parameters

- `symbol` string, required

## Query parameters

- `periodStart` string, date-time, required
- `periodEnd` string, date-time, required

## Response `200`

OK

- FireAntApiModelsIRIRReportRunItem: Một lần dựng báo cáo
  - `runId` integer: ID
  - `companyId` integer: ID công ty
  - `scheduleId` integer: Lịch phát sinh (null = chạy thủ công)
  - `periodStart` string, date-time: Từ ngày
  - `periodEnd` string, date-time: Đến ngày
  - `status` integer: Trạng thái: 0 chờ, 1 đang chạy, 2 xong, 3 lỗi
  - `fileUrl` string: Đường dẫn tệp báo cáo
  - `generatedDate` string, date-time: Thời điểm dựng xong
  - `sentCount` integer: Số người đã gửi
  - `error` string: Lỗi
  - `createdBy` string: Người tạo
  - `createdDate` string, date-time: Ngày tạo

## Changes

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

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