--- title: "List all reports" url: "https://docs.unified.to/ads/report/List_all_reports" description: "API reference for List all reports. Launch multiple pre-built Report integrations today with zero maintenance — all through a single API." generated_at: "2026-06-24T00:47:53.593Z" --- # List all reports GET/ads/{connection\_id}/report ## Parameters **limit**number default=100 **offset**number default=0 **updated\_gte**date Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **sort** enum name updated\_at created\_at **order** enum asc desc **query**string Query string to search. eg. email address or name **org\_id**string The org ID to filter by (reference to AdsOrganization) **campaign\_id**string The campaign ID to filter by **group\_id**string The group ID to filter by (reference to AdsGroup) **ad\_id**string The ad ID to filter by **type**string One or more (comma-separated) of: CLICKS, IMPRESSIONS, CONVERSIONS, COST, CTR, CPC, CONVERSION\_VALUE, CPA, ROAS, CPM, ECPM, ENGAGEMENT, VIDEO\_COMPLETIONS, VIDEO\_VIEWS, LEADS, ENGAGEMENTS, SAVES, LIKES, SHARES, COMMENTS, FOLLOWS, POST\_CLICK\_CONVERSIONS, VIEW\_THROUGH\_CONVERSIONS, ALL\_CONVERSIONS, ALL\_CONVERSION\_VALUE, INTERACTIONS, REVENUE, MEDIA\_COST, TOTAL\_MEDIA\_COST, VIDEO\_PLAYS, VIDEO\_QUARTILE\_25, VIDEO\_QUARTILE\_50, VIDEO\_QUARTILE\_75, VIDEO\_QUARTILE\_100, VIDEO\_AVG\_TIME\_WATCHED, VIDEO\_THRUPLAY, VIEWABLE\_IMPRESSIONS, MEASURABLE\_IMPRESSIONS, VIEWABILITY\_RATE, BILLABLE\_IMPRESSIONS, DATA\_FEES, PLATFORM\_FEES, PROFIT, LANDING\_PAGE\_CLICKS, LEAD\_FORM\_OPENS, AD\_UNIT\_CLICKS, CARD\_CLICKS, CARD\_IMPRESSIONS, COMMENT\_LIKES, COMPANY\_PAGE\_CLICKS, ACTION\_CLICKS, TEXT\_URL\_CLICKS, OTHER\_ENGAGEMENTS, OPENS, TOTAL\_ENGAGEMENTS, UNIQUE\_IMPRESSIONS, UNIQUE\_CLICKS, VIRAL\_IMPRESSIONS, VIRAL\_CLICKS, VIRAL\_LIKES, VIRAL\_COMMENTS, VIRAL\_SHARES, VIRAL\_FOLLOWS, VIRAL\_VIDEO\_PLAYS, VIRAL\_VIDEO\_VIEWS, VIRAL\_VIDEO\_COMPLETIONS, VIRAL\_VIDEO\_QUARTILE\_25, VIRAL\_VIDEO\_QUARTILE\_50, VIRAL\_VIDEO\_QUARTILE\_75, VIRAL\_LEADS, VIRAL\_LEAD\_FORM\_OPENS, VIRAL\_LANDING\_PAGE\_CLICKS, VIRAL\_CONVERSIONS, VIRAL\_POST\_CLICK\_CONVERSIONS, VIRAL\_VIEW\_THROUGH\_CONVERSIONS, VIRAL\_ENGAGEMENTS, GMAIL\_SECONDARY\_CLICKS, AVERAGE\_CPV, VIDEO\_VIEWS\_FROM\_SEARCH, CROSS\_DEVICE\_CONVERSIONS, ABSOLUTE\_TOP\_IMPRESSION\_SHARE, TOP\_IMPRESSION\_SHARE, VIDEO\_FULLSCREENS, VIDEO\_PAUSES, VIDEO\_MUTES, VIDEO\_SKIPS, COMPANION\_CLICKS, COMPANION\_VIEWS, ACTIVE\_VIEW\_AVG\_TIME, ELIGIBLE\_IMPRESSIONS, EARNED\_VIEWS, UNIQUE\_VIEWERS, COST\_USD, VIRAL\_CARD\_CLICKS, VIRAL\_CARD\_IMPRESSIONS, VIRAL\_COMPANY\_PAGE\_CLICKS, VIRAL\_VIDEO\_FULLSCREENS, VIRAL\_OTHER\_ENGAGEMENTS, LEAD\_GEN\_CONTACT\_SHARES, LEAD\_GEN\_INTERESTED\_CLICKS, CM360\_POST\_CLICK\_REVENUE, CM360\_POST\_VIEW\_REVENUE, SCROLLS, MEDIA\_FEE\_1, MEDIA\_FEE\_2, MEDIA\_FEE\_3, MEDIA\_FEE\_4, MEDIA\_FEE\_5, ACTIVE\_VIEW\_DIST\_UNMEASURABLE, ACTIVE\_VIEW\_DIST\_UNVIEWABLE, ACTIVE\_VIEW\_DIST\_VIEWABLE, ACTIVE\_VIEW\_AUDIBLE\_VISIBLE\_COMPLETE, ACTIVE\_VIEW\_VISIBLE\_10S, NOT\_MEASURABLE\_IMPRESSIONS, NOT\_VIEWABLE\_IMPRESSIONS, PUBLISHER\_PLATFORM, PLATFORM\_POSITION, IMPRESSION\_DEVICE, 1D\_VIEW, 1D\_CLICK, 7D\_VIEW, 7D\_CLICK, 14D\_CLICK, 28D\_VIEW, 28D\_CLICK, 30D\_CLICK **start\_gte**string The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **end\_lt**string The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **fields**string array id created\_at updated\_at currency metrics start\_at end\_at organization\_id raw Fields to return **raw**string Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar **connection\_id**string required ID of the connection ## Returns [AdsReport](/ads/report/model)array **id**string **created\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **updated\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **currency**string **metrics** array **start\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **end\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **organization\_id**string **raw**any ## Code Samples ### Node.js SDK ``` import { UnifiedTo } from '@unified-api/typescript-sdk'; const sdk = new UnifiedTo({ security: { jwt: '', }, }); const connectionId = '5de520f96e439b002043d8dc'; const results = await sdk.ads.listAdsReports({ connectionId, limit: 50, offset: 0, updated_gte: '2026-06-24T00:44:37.302Z', sort: 'updated_at', order: 'asc', query: '', org_id: '', campaign_id: '', group_id: '', ad_id: '', type: '', start_gte: '', end_lt: '', fields: '', raw: '', }); ``` ### Node.js (axios) ``` const options = { method: 'GET', url: 'https://api.unified.to/ads/5de520f96e439b002043d8dc/report', headers: { authorization: 'bearer .....' }, params: { limit: 50, offset: 0, updated_gte: '2026-06-24T00:44:37.302Z', sort: 'updated_at', order: 'asc', query: '', org_id: '', campaign_id: '', group_id: '', ad_id: '', type: '', start_gte: '', end_lt: '', fields: '', raw: '', } }; const results = await axios.request(options); ``` ### Java ``` AsyncHttpClient client = new DefaultAsyncHttpClient(); client.prepare("GET", "https://api.unified.to/ads/5de520f96e439b002043d8dc/report?limit=50&offset=0&updated_gte=2026-06-24T00:44:37.302Z&sort=updated_at&order=asc&query=&org_id=&campaign_id=&group_id=&ad_id=&type=&start_gte=&end_lt=&fields=&raw=") .setHeader("accept", "application/json") .setHeader("authorization", ".....") .execute() .toCompletableFuture() .thenAccept(System.out::println) .join(); client.close(); ``` ### Go ``` import ( "fmt" "net/http" "io/ioutil" ) url := `https://api.unified.to/ads/5de520f96e439b002043d8dc/report?limit=50&offset=0&updated_gte=2026-06-24T00:44:37.302Z&sort=updated_at&order=asc&query=&org_id=&campaign_id=&group_id=&ad_id=&type=&start_gte=&end_lt=&fields=&raw= req, _ := http.NewRequest("GET", url, nil) req.Header.Add("accept", "application/json") req.Header.Add("authorization", ".....") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) ``` ### Python ``` import requests url = "https://api.unified.to/ads/5de520f96e439b002043d8dc/report?limit=50&offset=0&updated_gte=2026-06-24T00:44:37.302Z&sort=updated_at&order=asc&query=&org_id=&campaign_id=&group_id=&ad_id=&type=&start_gte=&end_lt=&fields=&raw=" headers = { "accept": "application/json", "authorization": "....." } response = requests.get(url, headers=headers) ``` ### PHP ``` $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://api.unified.to/ads/5de520f96e439b002043d8dc/report?limit=50&offset=0&updated_gte=2026-06-24T00:44:37.302Z&sort=updated_at&order=asc&query=&org_id=&campaign_id=&group_id=&ad_id=&type=&start_gte=&end_lt=&fields=&raw=", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "accept: application/json", "authorization: ....." ], ]); ``` ### Ruby ``` require 'uri' require 'net/http' require 'openssl' url = URI("https://api.unified.to/ads/5de520f96e439b002043d8dc/report?limit=50&offset=0&updated_gte=2026-06-24T00:44:37.302Z&sort=updated_at&order=asc&query=&org_id=&campaign_id=&group_id=&ad_id=&type=&start_gte=&end_lt=&fields=&raw=") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["authorization"] = '....' response = http.request(request) puts response.read_body ``` ### cURL ``` curl --request GET \ --url 'https://api.unified.to/ads/5de520f96e439b002043d8dc/report?limit=50&offset=0&updated_gte=2026-06-24T00:44:37.302Z&sort=updated_at&order=asc&query=&org_id=&campaign_id=&group_id=&ad_id=&type=&start_gte=&end_lt=&fields=&raw=' \ --header 'accept: application/json' \ --header 'authorization: .....' ```