---
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-trang-thai-gui-tin-qua-sdt
title: API Lấy thông tin trạng thái gửi tin qua SĐT
---
# API Lấy thông tin trạng thái gửi tin qua SĐT

API cho phép đối tác truy xuất trạng thái gửi tin qua SĐT.

:::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/status 
- **Method:** GET 
- **Content Type:** application/json 
- **Response Type:** application/json

## Example request
```bash
curl
-X GET
-H "Content-Type: application/json" 
"https://business.openapi.zalo.me/message/status?message_id=message_id&phone=phone"
```

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


### Tham số

| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| message_id | string | yes | ID của thông báo cần lấy thông tin trạng thái. |


## Example respond
```json
{
   "message": "Success",
   "data": {
       "delivery_time": "1600328011517",
       "message": "The message was delivered to the user's phone",
       "status": 1
   },
   "error": 0
}
```

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

| Thuộc tính | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| delivery_time | string | Thời gian thiết bị của người dùng nhận được tin qua SĐT. |
| status | int | Trạng thái của tin qua SĐT. |
| message | string | Mô tả trạng thái tin qua SĐT. Các giá trị trả về: - -1: The message does not exist - 0: The message is pushed successfully to Zalo server but has not yet delivered to user’s phone - 1: The message was delivered to the user's phone |