Skip to main content

​
WhatsApp Business Cloud API - Business Compliance Information API

Copy for LLM View as Markdown Version v23.0 Retrieve WhatsApp Business Account compliance information for regulatory requirements. Returns business entity details, registration status, and contact information for grievance officers and customer care (primarily for India-based businesses). This endpoint allows businesses to retrieve comprehensive compliance information including entity details, registration status, and required contact information for regulatory compliance purposes.

​
Base URL

| https://graph.facebook.com |

​
Endpoints

| GET | ///business_compliance_info | | POST | ///business_compliance_info |

​
GET ///business_compliance_info

Retrieve comprehensive business compliance information for a WhatsApp Business Account phone number, including entity details, registration status, and required contact information for regulatory compliance. Use Cases: Retrieve business compliance information for regulatory reporting Verify business entity registration status and contact details Access grievance officer and customer care information Support compliance audits and regulatory verification processes Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff. Caching: Compliance information can be cached for moderate periods, but should be refreshed regularly to ensure accuracy for regulatory purposes. Implement appropriate cache invalidation strategies.

​
Request Syntax

GET///business_compliance_info Try it Select language cURLJavaScriptPython 
curl --request GET \
  --url 'https://graph.facebook.com/{Version}/{Phone-Number-ID}/business_compliance_info' \
  --header 'Authorization: Bearer <Token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
Select status code 200400401403404422429500 
\{
  "complete_compliance_info": {
    "summary": "Complete compliance information with all details",
    "value": {
      "data": [\
        {\
          "whatsapp_business_account_id": "1234567890123456",\
          "messaging_product": "whatsapp",\
          "entity_name": "Lucky Shrub Private Limited",\
          "entity_type": "Partnership",\
          "entity_type_custom": "",\
          "is_registered": true,\
          "grievance_officer_details": {\
            "name": "Chandravati P.",\
            "email": "[email protected]",\
            "mobile_number": "+913854559033",\
            "landline_number": "+913857614343"\
          },\
          "customer_care_details": {\
            "email": "[email protected]",\
            "mobile_number": "+913854559033",\
            "landline_number": "+913857614343"\
          }\
        }\
      ]
    }
  },
  "minimal_compliance_info": {
    "summary": "Minimal compliance information for unregistered business",
    "value": {
      "data": [\
        {\
          "whatsapp_business_account_id": "2345678901234567",\
          "messaging_product": "whatsapp",\
          "entity_name": "",\
          "entity_type": "",\
          "entity_type_custom": "",\
          "is_registered": false,\
          "grievance_officer_details": "",\
          "customer_care_details": ""\
        }\
      ]
    }
  }
}
Header Parameters
User-Agentstring The user agent string identifying the client software making the request. Authorizationstring·required Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token. Path Parameters
Versionstring·required Graph API version to use for this request. Determines the API behavior and available features. Phone-Number-IDstring·required Your WhatsApp Business Account phone number ID. This ID can be found in your WhatsApp Business Manager or through phone number management APIs. Query Parameters
fieldsstring Comma-separated list of fields to include in the response. If not specified, default fields will be returned. Available fields: messaging_product, entity_name, entity_type, entity_type_custom, is_registered, grievance_officer_details, customer_care_details Responses
Retrieve comprehensive business compliance information for a WhatsApp Business Account phone number, including entity details, registration status, and required contact information for regulatory compliance. Use Cases: Retrieve business compliance information for regulatory reporting Verify business entity registration status and contact details Access grievance officer and customer care information Support compliance audits and regulatory verification processes Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff. Caching: Compliance information can be cached for moderate periods, but should be refreshed regularly to ensure accuracy for regulatory purposes. Implement appropriate cache invalidation strategies. 200 Successfully retrieved business compliance information Content Type: application/json Schema: object Show child attributes
dataarray of BusinessComplianceInfo Show child attributes
data[]BusinessComplianceInfo WhatsApp Business Account compliance information and regulatory details Show child attributes
whatsapp_business_account_idstring·required Unique identifier for the WhatsApp Business Account
messaging_product”whatsapp” Messaging product identifier, always ‘whatsapp’ for WhatsApp Business
entity_namestring Legal name of the business entity
entity_typestring Type of business entity (e.g., Partnership, Private Limited Company, etc.) Show child attributes
entity_type_customstring Custom entity type description when standard types don’t apply
is_registeredboolean Whether the business entity is officially registered with regulatory authorities
grievance_officer_detailsGrievanceOfficerDetails Contact information for the designated grievance officer Show child attributes
namestring Full name of the grievance officer
emailstring (email) Email address for grievance officer contact
mobile_numberstring Mobile phone number for grievance officer (with country code)
landline_numberstring Landline phone number for grievance officer (with country code)
customer_care_detailsCustomerCareDetails Contact information for customer care and support Show child attributes
emailstring (email) Email address for customer care contact
mobile_numberstring Mobile phone number for customer care (with country code)
landline_numberstring Landline phone number for customer care (with country code) 400 Bad Request - Invalid parameters or malformed request Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 401 Unauthorized - Invalid or missing access token Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 403 Forbidden - Insufficient permissions or access denied Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 404 Not Found - Phone number ID does not exist or is not accessible Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 422 Unprocessable Entity - Request parameters are valid but cannot be processed Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 429 Too Many Requests - Rate limit exceeded Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 500 Internal Server Error - Unexpected server error Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes Select language cURLJavaScriptPython 
curl --request GET \
  --url 'https://graph.facebook.com/{Version}/{Phone-Number-ID}/business_compliance_info' \
  --header 'Authorization: Bearer <Token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
Select status code 200400401403404422429500 
\{
  "complete_compliance_info": {
    "summary": "Complete compliance information with all details",
    "value": {
      "data": [\
        {\
          "whatsapp_business_account_id": "1234567890123456",\
          "messaging_product": "whatsapp",\
          "entity_name": "Lucky Shrub Private Limited",\
          "entity_type": "Partnership",\
          "entity_type_custom": "",\
          "is_registered": true,\
          "grievance_officer_details": {\
            "name": "Chandravati P.",\
            "email": "[email protected]",\
            "mobile_number": "+913854559033",\
            "landline_number": "+913857614343"\
          },\
          "customer_care_details": {\
            "email": "[email protected]",\
            "mobile_number": "+913854559033",\
            "landline_number": "+913857614343"\
          }\
        }\
      ]
    }
  },
  "minimal_compliance_info": {
    "summary": "Minimal compliance information for unregistered business",
    "value": {
      "data": [\
        {\
          "whatsapp_business_account_id": "2345678901234567",\
          "messaging_product": "whatsapp",\
          "entity_name": "",\
          "entity_type": "",\
          "entity_type_custom": "",\
          "is_registered": false,\
          "grievance_officer_details": "",\
          "customer_care_details": ""\
        }\
      ]
    }
  }
}

​
POST ///business_compliance_info

Create or update comprehensive business compliance information for a WhatsApp Business Account phone number, including entity details, registration status, and required contact information for regulatory compliance. Use Cases: Set business compliance information for regulatory reporting Update business entity registration status and details Configure grievance officer and customer care contact information Ensure compliance data accuracy for regulatory purposes Support compliance setup for new business operations Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff. Validation Rules: entity_name is required and must be between 2 and 128 characters entity_type is required and must be a valid entity type enum value entity_type_custom is mandatory when entity_type is “Other” entity_type_custom cannot be used with non-”Other” entity types is_registered can only be used with “Other” or “Partnership” entity types grievance_officer_details is required with complete contact information customer_care_details is required with contact information Phone numbers must be valid international format with country code Email addresses must be valid format and under 128 characters

​
Request Syntax

POST///business_compliance_info Try it Select language cURLJavaScriptPython 
curl --request POST \
  --url 'https://graph.facebook.com/{Version}/{Phone-Number-ID}/business_compliance_info' \
  --header 'Authorization: Bearer <Token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "messaging_product": "whatsapp",
  "entity_name": "Lucky Shrub Private Limited",
  "entity_type": "PARTNERSHIP",
  "is_registered": true,
  "grievance_officer_details": {
    "name": "Chandravati P.",
    "email": "[email protected]",
    "mobile_number": "+913854559033",
    "landline_number": "+913857614343"
  },
  "customer_care_details": {
    "email": "[email protected]",
    "mobile_number": "+913854559033",
    "landline_number": "+913857614343"
  }
}'
Select status code 200400401403404422429500 
\{
  "successful_update": {
    "summary": "Successful compliance information update",
    "value": {
      "success": true
    }
  }
}
Header Parameters
User-Agentstring The user agent string identifying the client software making the request. Authorizationstring·required Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token. Path Parameters
Versionstring·required Graph API version to use for this request. Determines the API behavior and available features. Phone-Number-IDstring·required Your WhatsApp Business Account phone number ID. This ID can be found in your WhatsApp Business Manager or through phone number management APIs. Request BodyRequired
Content Type: application/json Schema: BusinessComplianceInfoUpdateRequest Show child attributes
BusinessComplianceInfoUpdateRequest
messaging_product”whatsapp”·required Messaging product identifier, must be ‘whatsapp’
entity_namestring·required Legal name of the business entity
entity_typeBusinessEntityType Type of business entity for compliance purposes Show child attributes
entity_type_customstring Custom entity type description when entity_type is “OTHER”. Required for OTHER entity type.
is_registeredboolean Whether the business entity is officially registered with regulatory authorities. Can only be used with “OTHER” or “PARTNERSHIP” entity types.
grievance_officer_detailsGrievanceOfficerUpdateDetails Contact information for the designated grievance officer Show child attributes
namestring·required Full name of the grievance officer
emailstring (email)·required Email address for grievance officer contact
mobile_numberstring Mobile phone number for grievance officer (with country code)
landline_numberstring Landline phone number for grievance officer (with country code)
customer_care_detailsCustomerCareUpdateDetails Contact information for customer care and support Show child attributes
emailstring (email)·required Email address for customer care contact
mobile_numberstring Mobile phone number for customer care (with country code)
landline_numberstring Landline phone number for customer care (with country code) Responses
Create or update comprehensive business compliance information for a WhatsApp Business Account phone number, including entity details, registration status, and required contact information for regulatory compliance. Use Cases: Set business compliance information for regulatory reporting Update business entity registration status and details Configure grievance officer and customer care contact information Ensure compliance data accuracy for regulatory purposes Support compliance setup for new business operations Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff. Validation Rules: entity_name is required and must be between 2 and 128 characters entity_type is required and must be a valid entity type enum value entity_type_custom is mandatory when entity_type is “Other” entity_type_custom cannot be used with non-”Other” entity types is_registered can only be used with “Other” or “Partnership” entity types grievance_officer_details is required with complete contact information customer_care_details is required with contact information Phone numbers must be valid international format with country code Email addresses must be valid format and under 128 characters 200 Successfully updated business compliance information Content Type: application/json Schema: object Show child attributes
successboolean·required Indicates whether the compliance information was successfully updated 400 Bad Request - Invalid parameters or validation errors Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 401 Unauthorized - Invalid or missing access token Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 403 Forbidden - Insufficient permissions or access denied Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 404 Not Found - Phone number ID does not exist or is not accessible Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 422 Unprocessable Entity - Request parameters are valid but cannot be processed Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 429 Too Many Requests - Rate limit exceeded Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 500 Internal Server Error - Unexpected server error Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes Select language cURLJavaScriptPython 
curl --request POST \
  --url 'https://graph.facebook.com/{Version}/{Phone-Number-ID}/business_compliance_info' \
  --header 'Authorization: Bearer <Token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "messaging_product": "whatsapp",
  "entity_name": "Lucky Shrub Private Limited",
  "entity_type": "PARTNERSHIP",
  "is_registered": true,
  "grievance_officer_details": {
    "name": "Chandravati P.",
    "email": "[email protected]",
    "mobile_number": "+913854559033",
    "landline_number": "+913857614343"
  },
  "customer_care_details": {
    "email": "[email protected]",
    "mobile_number": "+913854559033",
    "landline_number": "+913857614343"
  }
}'
Select status code 200400401403404422429500 
\{
  "successful_update": {
    "summary": "Successful compliance information update",
    "value": {
      "success": true
    }
  }
}

​
Authentication

| Scheme | Type | Location | | bearerAuth | HTTP Bearer | Header: Authorization |

​
Usage Examples

bearerAuth: Include Authorization: Bearer your-token-here in request headers

​
Global Authentication Requirements

All endpoints require: bearerAuth Did you find this page helpful? Thumbs up icon Thumbs down icon