---
title: "Get WhatsApp Business Account Message History"
method: GET
path: "/{Version}/{Phone-Number-ID}/message_history"
tags: ["Message History"]
---

# Get WhatsApp Business Account Message History

`GET /{Version}/{Phone-Number-ID}/message_history`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{Phone-Number-ID}/message_history`
- Auth: HTTP bearer

Retrieve paginated message history for a WhatsApp Business Account phone number,
including delivery status events, timestamps, and webhook update information.


**Use Cases:**
- Track message delivery status and events
- Monitor webhook delivery and update states
- Retrieve historical message delivery information
- Debug message delivery issues and webhook failures


**Rate Limiting:**
Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.


**Caching:**
Message history data can be cached for moderate periods, but delivery status events
may change frequently. Implement appropriate cache invalidation strategies.


**Pagination:**
This endpoint supports cursor-based pagination. Use the `after` and `before` cursors
from the response to navigate through results.

## Path parameters

- `Version` string, required
- `Phone-Number-ID` string, required

## Query parameters

- `message_id` string
- `fields` string
- `limit` integer
- `after` string
- `before` string

## Headers

- `User-Agent` string
- `Authorization` string, required

## Response `200`

Successfully retrieved WhatsApp Business Account message history

- MessageHistoryResponse: Paginated response containing message history entries
  - `data` WhatsAppMessageHistory[]: Array of message history entries
    - `id` string, required: Unique identifier for the message history entry
    - `message_id` string, required: WhatsApp message ID (WAMID) for the message
    - `events` object: Message delivery status events and occurrences
      - `data` MessageDeliveryStatusEvent[]: Array of delivery status events
        - `id` string, required: Unique identifier for the delivery status event
        - `delivery_status` 'SENT' | 'DELIVERED' | 'READ' | 'FAILED' | 'DELETED', required: Message delivery status
        - `webhook_update_state` 'PENDING' | 'DELIVERED' | 'FAILED' | 'RETRYING': State of webhook update delivery
        - `timestamp` integer, required: Unix timestamp when the delivery status event occurred
        - `application` object: Application information for the event
          - `id` string: Application ID that processed the event
        - `webhook_uri` string, uri: Webhook URI where the event was delivered
        - `error_description` string: Error description if the delivery failed
      - `paging` PaginationInfo: Pagination information for navigating through results
        - `cursors` object: Pagination cursors for navigation
          - `before` string: Cursor for the previous page of results
          - `after` string: Cursor for the next page of results
        - `previous` string, uri: URL for the previous page of results
        - `next` string, uri: URL for the next page of results
  - `paging` PaginationInfo: Pagination information for navigating through results
    - `cursors` object: Pagination cursors for navigation
      - `before` string: Cursor for the previous page of results
      - `after` string: Cursor for the next page of results
    - `previous` string, uri: URL for the previous page of results
    - `next` string, uri: URL for the next page of results

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - Phone number ID does not exist or is not accessible
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)