MEmeta
WhatsApp Business Account On-Behalf Requests

Get In-Progress On-Behalf Requests

Retrieve a list of in-progress on-behalf requests for the specified WhatsApp Business Account. These requests represent pending business relationship requests that have been sent from this WhatsApp Business Account to other businesses and are awaiting approval.

Use Cases:

  • Monitor pending on-behalf requests sent from your WhatsApp Business Account
  • Track business partnership request status and workflow
  • Retrieve details about requesting and receiving businesses for pending requests
  • Manage business relationship approval processes

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

Pagination: This endpoint supports cursor-based pagination. Use the 'after' and 'before' parameters to navigate through large result sets. The response includes pagination URLs for convenience.

get/{Version}/{WABA-ID}/in_progress_onbehalf_request

Request

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

Path parameters

Versionstring required

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

WABA-IDstring required

Your WhatsApp Business Account ID. This ID can be found in your WhatsApp Business Manager or through the WhatsApp Business Account APIs.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, status, business_owned_object). Available fields: id, status, business_owned_object, receiving_business, requesting_business

limitinteger

Maximum number of results to return per page. Default is 25, maximum is 100.

afterstring

Cursor for forward pagination. Use this to get the next page of results.

beforestring

Cursor for backward pagination. Use this to get the previous page of results.

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 in-progress on-behalf requests

Example response

{
  "data": [
    {
      "id": "1234567890123456",
      "status": "IN_PROGRESS",
      "business_owned_object": "9876543210987654",
      "receiving_business": {
        "id": "9876543210987654",
        "name": "Example Business Inc"
      },
      "requesting_business": {
        "id": "9876543210987654",
        "name": "Example Business Inc"
      }
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MTAxNTExOTQ1MjAwNzI5NDE="
    },
    "previous": "https://graph.facebook.com/v23.0/1234567890123456/message_history?before=MAZDZD",
    "next": "https://graph.facebook.com/v23.0/1234567890123456/message_history?after=MTAxNTExOTQ1MjAwNzI5NDE="
  }
}

Changes

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