---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/quan-ly/quan-ly-thong-tin-oa/kiem-tra-han-muc-tin-nhan-oa
title: Kiểm tra hạn mức tin nhắn OA
---
# Kiểm tra hạn mức tin nhắn OA

## Bạn có thể sử dụng API để lấy quota tin chi tiết theo:

- **Loại tin:** Tư vấn / Giao dịch
- **Thực thể sở hữu quota:** OA / App
- **Nguồn quota:** quota miễn phí từ gói dịch vụ OA / quota từ gói mua lẻ 

:::warning Lưu ý
**Quyền cần có:** Quyền quản lý thông tin OA
:::

## HTTP request

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

## Example request
```bash
curl --location 'https://openapi.zalo.me/v3.0/oa/quota/message' \
--header 'access_token: <oa_access_token>' \
--header 'Content-Type: application/json' \
--data '{
    "quota_owner": "OA"
}'
```

### **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). |


### **Cấu trúc body của request**

| Column 1 | Column 2 | Column 3 | Column 4 |
| --- | --- | --- | --- |
| Thuộc tính | Kiểu dữ liệu | Bắt buộc | Mô tả |
| quota_owner | string | Yes | Thực thể sở hữu Quota muốn truy xuất OA / APP |
| product_type | string | No | loại sản phẩm thuộc nhánh tính năng muốn truy xuất: - cs: tin Tư vấn - transaction: tin Giao dịch |
| quota_type | string | No | loại quota (nguồn quota sử dụng) muốn truy xuất: - sub_quota: quota tin theo gói dịch vụ OA - purchase_quota: quota tin mua lẻ - reward_quota: quota tin được tặng từ các chương trình khuyến mãi |


## Example respond
```json
{
  "data": [
    {
      "asset_id": "216991e1ea59bc03e54c",
      "product_type": "cs",
      "quota_type": "sub_quota",
      "valid_through": "10/10/2024",
      "total": 2000,
      "remain": 1990
    },
    {
      "asset_id": "cdfef30e10c5399f60d0",
      "product_type": "transaction",
      "quota_type": "purchase_quota",
      "valid_through": "10/12/2024",
      "total": 5000,
      "remain": 1200
    },
    {
      "asset_id": "988332fbc118e842b10d",
      "product_type": "transaction",
      "quota_type": "purchase_quota",
      "valid_through": "10/10/2024",
      "total": 2000,
      "remain": 1990
    },
    {
      "asset_id": "ec88cd4123a20af853b7",
      "product_type": "transaction",
      "quota_type": "reward_quota",
      "valid_through": "10/11/2024",
      "total": 2000,
      "remain": 2000
    }
  ],
  "error": 0,
  "message": "success"
}
```

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


| Thuộc tính | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| asset_id | string | ID của asset |
| product_type | string | loại sản phẩm thuộc nhánh tính năng |
| quota_type | string | loại quota (nguồn quota sử dụng) Giá trị theo bảng quota_type |
| valid_through | string | ngày hết hạn của của asset_id |
| total | string | tổng số lượng quota CHƯA hết hạn (bao gồm available + used) của asset_id |
| remain | string | số lượng quota ở trạng thái available của asset_id |