MEmeta
Application Business Connections

Get Connected Client Businesses

Retrieve a list of client businesses connected to the specified application.

Use Cases:

  • Monitor application-business client relationships
  • Verify connected business configurations
  • Retrieve business connection status and details
  • Manage client business access and permissions

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

Caching: Business connection data can be cached for moderate periods, but status information may change. Implement appropriate cache invalidation strategies.

get/{Version}/{Application-ID}/connected_client_businesses

Request

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

Path parameters

Versionstring required

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

Application-IDstring required

Your Meta Application ID. This ID is provided when you create the application and can be found in your App Dashboard.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, name, verification_status, business_status). Available fields: id, name, verification_status, business_status, created_time, updated_time

limitinteger

Maximum number of connected client businesses to return per page. Default is 25, maximum is 100.

afterstring

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

beforestring

Cursor for 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 connected client businesses

Example response

{
  "data": [
    {
      "id": "1234567890123456",
      "name": "Example Client Business",
      "verification_status": "VERIFIED",
      "business_status": "ACTIVE",
      "created_time": "2023-01-15T10:30:00Z",
      "updated_time": "2023-06-20T14:45:00Z"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUjNpUWpVWmRBd0dn",
      "after": "QVFIUjNpUWpVWmRBd0Rn"
    },
    "previous": "https://graph.facebook.com/v23.0/1234567890/connected_client_businesses?before=QVFIUjNpUWpVWmRBd0Dn",
    "next": "https://graph.facebook.com/v23.0/1234567890/connected_client_businesses?after=QVFIUjNpUWpVWmRBd0Rn"
  }
}

Changes

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