Appearance
Check seller eligibility
Updated: Jun 21, 2026
This page gives guidance on which sellers to onboard into managed partner ads, as well as how to check eligibility. You may begin onboarding any eligible seller, but consider prioritizing sellers with a higher average purchase value. Such sellers tend to have better return on ad spend.
Before you begin
Before you check the eligibility of a seller, make sure you have completed these steps:
- Create an Admin System User
- Assign Permissions to the Admin System User
- Generate an Access Token for the Admin System User
Seller eligibility criteria
A seller qualifies when it meets the following criteria:
- Average purchase value in the past 28 days
- Number of purchases in the past 28 days
Note: Sellers with a higher average purchase value tend to have better return on ad spend. Prioritize these sellers when you onboard. You can download a list of your eligible and recommended sellers from the Discover page in Collaboration Center.
Required permissions
To call the Seller Eligibility API, you need the following permissions:
- Business Admin
- Catalog Admin
- Manage Credit
- App Developer
Seller eligibility API call
Request
curl -X GET \
"https://graph.facebook.com/v<API_VERSION>/<Business_ID>?fields=collaborative_ads_managed_partner_eligibility.vendor_id(<INSERT_VENDOR_ID>).catalog_id(<INSERT_CATALOG_ID>)&access_token=<ACCESS_TOKEN>"Request parameters
| Name | Description |
|---|---|
catalog_id numeric string | Required. The ID of the marketplace's catalog, referred to as a parent catalog. During onboarding, this catalog may be filtered using vendor_id=<child_business_external_id> to create a catalog segment for a seller. |
marketplace_bm_id string | Required. The marketplace's Business Manager ID. See Find your Business ID in Meta Business Suite for more information. |
vendor_id string | Required. The unique ID of the seller for a marketplace. |
Response
{
"is_eligible": bool,
"reason_code": "enum string",
"reason_description": "enum string",
}Response fields
| Name | Description |
|---|---|
is_eligible bool | Indicates whether the seller is eligible. |
reason_code enum string | The reason code for the seller's eligibility. Empty if the seller is eligible. |
reason_description enum string | A description of the eligibility reason. Empty if seller is eligible. |
Error codes
| Error Code | Error Subcode | Description |
|---|---|---|
| 1800000 | 2310114 | Complete the managed partner ads onboarding process in Collaboration Center. |
| 1800012 | 2310173 | Check the marketplace you entered ({marketplace_id}). If it's the correct ID, ask someone with full control to go to Business settings in Meta Business Suite to give you admin access. Once assigned, retry the request. |
| 1800101 | 2310116 | Your business {business_id} does not manage the catalog ID you entered {catalog_id}. Enter a catalog ID that your business manages. |