---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: >-
  ZBS/gui-tin-template-qua-sdt/api-truy-xuat-thong-tin-gui-tin-qua-sdt/api-lay-thong-tin-quota-gui-tin-qua-sdt
title: API Lấy thông tin quota gửi tin qua SĐT
---
# API Lấy thông tin quota gửi tin qua SĐT

API cho phép đối tác truy xuất thông tin quota (số lượng) gửi tin qua SĐT của OA được gửi mỗi ngày.

:::warning Lưu ý
**Quyền cần có:** Gửi tin qua số điện thoại
:::

## HTTP request

- **URL:** https://business.openapi.zalo.me/message/quota 
- **Method:** GET 
- **Content Type:** application/json 
- **Response Type:** text/json

## Example request
```bash
curl
-X GET
-H "Content-Type: application/json" "https://business.openapi.zalo.me/message/quota"
```

### 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 | Đoạn mã cần truyền vào để xác minh quyền sử dụng API. Xem thêm [tài liệu tham khảo](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new) |


## Example respond
```json
{
    "data": {
        "dailyQuota": 500,
        "remainingQuota": 499,
        "dailyQuotaPromotion": null,
        "remainingQuotaPromotion": null,
        "monthlyPromotionQuota": 125,
        "remainingMonthlyPromotionQuota": 124,
        "estimatedNextMonthPromotionQuota" :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ả |
| --- | --- | --- |
| dailyQuota | long | Số tin qua SĐT của OA được gửi trong 1 ngày. Lưu ý: Hạn mức gửi tin qua SĐT mỗi ngày của OA sẽ tự động được điều chỉnh dựa theo chất lượng và nhu cầu gửi. Xem thêm chi tiết về cơ chế đánh giá chất lượng và quyền lợi gửi tin qua SĐT [tại đây](/docs/ZBS/phu-luc/co-che-danh-gia-chat-luong-va-quyen-loi-gui-tin-qua-sdt). |
| remainingQuota | long | Số tin qua SĐT còn lại của OA được gửi trong ngày. |
| dailyQuotaPromotion | string | Số tin hậu mãi của OA được gửi trong ngày. Ghi chú: Từ ngày 1/11, thuộc tính này sẽ trả về giá trị null |
| remainingQuotaPromotion | string | Số tin hậu mãi còn lại của OA được gửi trong ngày. Ghi chú: Từ ngày 1/11, thuộc tính này sẽ trả về giá trị null |
| monthlyPromotionQuota | long | Số tin hậu mãi của OA được gửi trong tháng. |
| remainingMonthlyPromotionQuota | long | Số tin hậu mãi còn lại của OA được gửi trong tháng. |
| estimatedNextMonthPromotionQuota | long | Số tin hậu mãi dự kiến mà OA có thể gửi trong tháng tiếp theo. |