WhatsApp Business Profiles

Get WhatsApp Business Profile Details

Retrieve comprehensive details about a WhatsApp Business Profile, including business information, contact details, and profile configuration.

Use Cases:

  • Retrieve business profile information and metadata
  • Verify profile configuration and contact details
  • Check profile status and business information
  • Validate profile state before business operations

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

Caching: Profile details can be cached for moderate periods, but business information may change occasionally. Implement appropriate cache invalidation strategies.

get/{Version}/{WhatsApp-Business-Profile-ID}

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{WhatsApp-Business-Profile-ID}
  • Auth
    HTTP bearer

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

WhatsApp-Business-Profile-IDstring required

Your WhatsApp Business Profile ID. This ID is provided when the profile is created and can be found in your WhatsApp Business Manager or through business management APIs.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id and any available profile fields). Available fields: id, account_name, description, email, about, address, vertical, websites, profile_picture_url, messaging_product

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Response

Successfully retrieved WhatsApp Business Profile details

idstring required

Unique identifier for the WhatsApp Business Profile

account_namestring

Name of the business account

descriptionstring

Business description text

emailstring email

Contact email address of the business

aboutstring

About section text for the business profile

addressstring

Physical address of the business

vertical'OTHER' | 'AUTO' | 'BEAUTY' | 'APPAREL' | 'EDU' | 'ENTERTAIN' | 'EVENT_PLAN' | 'FINANCE' | 'GROCERY' | 'GOVT' | 'HOTEL' | 'HEALTH' | 'NONPROFIT' | 'PROF_SERVICES' | 'RETAIL' | 'TRAVEL' | 'RESTAURANT' | 'ALCOHOL' | 'ONLINE_GAMBLING' | 'PHYSICAL_GAMBLING' | 'OTC_DRUGS'

The industry type of the business

websitesstring[]

List of website URLs associated with the business

profile_picture_urlstring uri

URL of the business profile picture

profile_picture_handlestring

Handle of the profile picture for upload operations

messaging_product'whatsapp'

The messaging service used

Example response

{
  "id": "1234567890123456",
  "account_name": "E-commerce Business Account",
  "description": "Leading e-commerce platform for quality products",
  "email": "contact@business-example.com",
  "about": "Quality products delivered worldwide",
  "address": "123 Business Street, Commerce City, CC 12345",
  "vertical": "RESTAURANT",
  "websites": [
    "https://www.business-example.com",
    "https://shop.business-example.com"
  ],
  "profile_picture_url": "https://pps.whatsapp.net/v/profile-picture-url",
  "profile_picture_handle": "4:VGVzdC5wbmc=:aW1hZ2UvanBlZw==:ARat4Mt-L09JON3f30SmDkdyPSuyBkDDYiB4TFXuXISjdgHoNp2b7j882_9Jzr2tPrdKxi92UygyVzTivJiOvmebMpZ6MIjTik3gTyI3ZCQAgQ:e:1659995302:2022308451254161:636685196:ARZf1ftR5N6-qSLtklU",
  "messaging_product": "whatsapp"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.