---
title: "Get WhatsApp Business Account Activities"
method: GET
path: "/{Version}/{WABA-ID}/activities"
tags: ["WhatsApp Business Account Activities"]
---

# Get WhatsApp Business Account Activities

`GET /{Version}/{WABA-ID}/activities`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{WABA-ID}/activities`
- Auth: HTTP bearer

Retrieve activity logs and audit trails for a WhatsApp Business Account.
This endpoint returns a chronological list of activities performed on the account,
including administrative actions, configuration changes, and operational events.

**Use Cases:**
- Monitor account configuration changes and administrative actions
- Generate compliance and audit reports for regulatory requirements
- Track user activities and permission modifications
- Investigate security incidents and unauthorized access attempts
- Monitor API usage patterns and operational events

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

**Caching:**
Activity data can be cached for short periods, but recent activities may change
frequently. Implement appropriate cache invalidation strategies.

## Path parameters

- `Version` string, required
- `WABA-ID` string, required

## Query parameters

- `fields` string
- `limit` integer
- `after` string
- `before` string
- `since` string
- `until` string
- `activity_type` string

## Headers

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

## Response `200`

Successfully retrieved WhatsApp Business Account activities

- ActivityList: Paginated list of WhatsApp Business Account activities
  - `data` WhatsAppBusinessAccountActivity[], required: Array of activity records
    - `id` string, required: Unique identifier for the activity record
    - `activity_type` 'ACCOUNT_CREATED' | 'ACCOUNT_UPDATED' | 'ACCOUNT_DELETED' | 'PHONE_NUMBER_ADDED' | 'PHONE_NUMBER_REMOVED' | 'PHONE_NUMBER_VERIFIED' | 'USER_ADDED' | 'USER_REMOVED' | 'USER_ROLE_CHANGED' | 'PERMISSION_GRANTED' | 'PERMISSION_REVOKED' | 'TEMPLATE_CREATED' | 'TEMPLATE_UPDATED' | 'TEMPLATE_DELETED' | 'WEBHOOK_CONFIGURED' | 'API_ACCESS_GRANTED' | 'API_ACCESS_REVOKED' | 'BILLING_UPDATED' | 'COMPLIANCE_ACTION' | 'SECURITY_EVENT', required: Type of activity performed on the WhatsApp Business Account
    - `timestamp` string, date-time, required: ISO 8601 timestamp when the activity occurred
    - `actor_type` 'USER' | 'SYSTEM' | 'API' | 'ADMIN' | 'AUTOMATED_PROCESS', required: Type of entity that performed the activity
    - `actor_id` string: ID of the user or system that performed the activity
    - `actor_name` string: Name of the user or system that performed the activity
    - `description` string: Human-readable description of the activity
    - `details` object: Additional structured details about the activity
    - `ip_address` string: IP address from which the activity was performed (when available)
    - `user_agent` string: User agent string from the client that performed the activity
  - `paging` Paging
    - `cursors` PaginationCursors
      - `after` string
      - `before` string

## 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 - WhatsApp Business Account 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)