Ads and Commerce
Ads and Commerce
Resources

Ad Campaign Publisher Delivery Report

Updated: Apr 7, 2025

Reading

Publisher delivery report for a specified ad set.

Example

GET /v25.0/{ad-set-id}/publisher_delivery_report HTTP/1.1
Host: graph.facebook.com
Try it in Graph API Explorer
If you want to learn how to use the Graph API, read our Using Graph API guide

Parameters

Parameter Description
end_date
datetime
The end date for the delivery report
name_contains
string
What substring the name of publishers returned should contain
platform
enum {AUDIENCE_NETWORK, FACEBOOK, INSTAGRAM, MESSENGER, WHATSAPP, WHATSAPP_STATUS, OCULUS, THREADS, UNKNOWN, HIDDEN_AAA}
The platform type of the publisher delivery report requested
required
position
enum {ALL_PLACEMENTS, AN_CLASSIC, FEED, GROUPS, FACEBOOK_GROUPS_FEED, INSTAGRAM_STORIES, MESSENGER_INBOX, RIGHT_HAND_COLUMN, OTHERS, SEARCH, INSTANT_ARTICLE, INSTREAM_VIDEO, REWARDED_VIDEO, SUGGESTED_VIDEO, MARKETPLACE, FACEBOOK_STORIES, MESSENGER_STORIES, STATUS, INSTAGRAM_EXPLORE, UNKNOWN, VIDEO_FEEDS, INSTAGRAM_IGTV, HIDDEN_AAA, JOBS_BROWSER, OCULUS_TWILIGHT_FEED, STICKERS, INSTAGRAM_REELS, INSTAGRAM_SHOP, OCULUS_VR_APPS, BIZ_DISCO_FEED, OCULUS_REWARDED_VIDEO, OCULUS_TWILIGHT_FEED_SPOTLIGHT, OCULUS_TWILIGHT_SEARCH, OCULUS_TWILIGHT_SEARCH_NULL_STATE, FACEBOOK_REELS, OCULUS_TWILIGHT_DEVELOPER_UPDATE, FACEBOOK_REELS_OVERLAY, INSTAGRAM_REELS_OVERLAY, INSTAGRAM_EFFECT_TRAY, INSTAGRAM_EXPLORE_GRID_HOME, INSTAGRAM_PROFILE_FEED, INSTAGRAM_PROFILE_REELS, FACEBOOK_PROFILE_FEED, INSTAGRAM_SEARCH, ADS_ON_FACEBOOK_REELS, INSTAGRAM_LEAD_GEN_MULTI_SUBMIT, WHATSAPP_MARKETING_MESSAGES, FACEBOOK_PROFILE_REELS, THREADS_FEED, WHATSAPP_CHANNEL, FACEBOOK_NOTIFICATION, MESSENGER_MARKETING_MESSAGES, FACEBOOK_MULTI_ADS, FACEBOOK_REELS_BANNER, FACEBOOK_REELS_POSTLOOP, FACEBOOK_INSTREAM_BANNER, FACEBOOK_INSTREAM_VIDEO, INSTAGRAM_REELS_INSTREAM}
The position of the publisher delivery report requested
required
publisher_status
enum {ALL, PARTNER, NON_PARTNER}

Default value: "ALL"
An in-stream publisher status to filter
sort_by
enum {URL_ASCENDING, URL_DESCENDING, NAME_ASCENDING, NAME_DESCENDING, IMPRESSIONS_ASCENDING, IMPRESSIONS_DESCENDING}

Default value: "IMPRESSIONS_DESCENDING"
Which category and direction the report is sorted by
start_date
datetime
The start date for the delivery report
summary
boolean

Default value: true
summary

Fields

Reading from this edge will return a JSON formatted result: 
{
"data": [],
"paging": {},
"summary": {}
}
data
A list of PublisherDeliveryReport nodes.
paging
For more details about pagination, see the Graph API guide.
summary
Aggregated information about the edge, such as counts. Specify the fields to fetch in the summary param (like summary=__type__).
Field Description
end_date
string
The end date for the delivery report

default
non_partner_count
unsigned int32
Number of rows of non in-stream partner returned

default
start_date
string
The start date for the delivery report

default
total_count
unsigned int32
Total number of rows in the report

default

Error Codes

Error Code Description
100
Invalid parameter

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon