---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/v2/lay-thong-tin-quota-lenh-chu-dong-mien-phi
title: Lấy thông tin quota lệnh chủ động miễn phí
---
# Lấy thông tin quota lệnh chủ động miễn phí

Bạn có thể sử dụng API lấy thông tin quota lệnh chủ động để kiểm tra số lượng lệnh chủ động miễn phí đã sử dụng. 

:::warning Lưu ý
**Quyền cần có:** Quyền gửi tin và thông báo qua OA 
:::

## HTTP request

- **URL:** https://openapi.zalo.me/v2.0/oa/quota/message 
- **Method:** POST 
- **Content Type:** application/json 
- **Response Type:** text/json

## Example request
```bash
curl
-X POST
-H 'Content-Type: application/json'
-H 'access_token: <your_access_token>'
'https://openapi.zalo.me/v2.0/oa/quota/message'
```

### **Tham số header**

| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| [access_token](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new) | string | yes | Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token [tại đây](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new). |


## Example respond
```json
{
    "data": {
        "type": "active",
        "remain": 450,
        "total": 1000 
    }, 
    "error": 0,
    "message": "Success"
}
```

### **Cấu trúc thuộc tính data**

| Column 1 | Column 2 | Column 3 |
| --- | --- | --- |
| Thuộc tính | Kiểu dữ liệu | Mô tả |
| type | string | Giá trị trả về là active cho biết đây là quota của lệnh chủ động. |
| remain | int | Số lượng lệnh chủ động miễn phí còn lại |
| total | int | Tổng số lượng lệnh chủ động miễn phí có thể sử dụng. Xem thêm [Chính sách gửi tin](https://oa.zalo.me/home/faq/thong-bao-moi-list10/#50). |