> ## Documentation Index > Fetch the complete documentation index at: https://docs.contentignite.com/llms.txt > Use this file to discover all available pages before exploring further. # /report/insight/revenue/dimension > Revenue and ad delivery broken down by one dimension, such as publisher, ad unit type, country, device or partner. The figures match `/v1/report/insight/revenue`, and rates are worked out the same way: Fill = `impressions ÷ ad_requests`, Ad Server Fill = `ad_responses ÷ ad_requests`, Unit Fill = `ad_responses ÷ ad_unit_loads` ## OpenAPI ````yaml /openapi.json get /v1/report/insight/revenue/dimension openapi: 3.0.1 info: title: CI Public API description: >- # Introduction Welcome to the Content Ignite API. A central place for all Content Ignite functionality. This API enforces a separation between function and form, meaning anything you can do in our platforms can be replicated in your own bespoke solution. # Authentication Authentication is handled via JWTs. You can retrieve your unique JSON Web Token from the settings page in the platform, which needs to be passed in with every request. To do this, simple include it in an Authorization header with the "Bearer" key word. Please contact support for help getting started. # Error Codes This is a fully RESTful API, so prepare for a number of different HTTP status codes. There is also a standard "success" field returned for each request. This boolean value can provide a first check against a response. # Rate limit We reserve the right to block requests if we deem a client to be abusing the API. version: 1.0.0 servers: - url: https://api.tagdeliver.com description: Production security: - BearerAuth: [] tags: - name: Reporting - name: Reporting/Revenue Reports - name: Reporting/Experiment Reporting - name: Reporting/Campaign Reports - name: Reporting/Health Check - name: Reporting/Ads.txt - name: Reporting/Utility - name: Reporting/Insights Hub - name: Reporting/Insights Hub/SSP Insights - name: Reporting/Insights Hub/Core Web Vitals - name: Reporting/Insights Hub/Ads.txt Insights - name: Reporting/Insights Hub/Live Insights - name: Reporting/Insights Hub/Metrics - name: Reporting/Insights Hub/Diagnostics - name: Reporting/Insights Hub/Revenue Insights - name: Reporting/Insights Hub/Revenue Analytics - name: Reporting/Insights Hub/Demand Mix - name: Reporting/Insights Hub/Benchmarking - name: Organisation - name: Organisation/Organisation Meta - name: Organisation/Pricing - name: Ad Stack - name: Ad Stack/Integration - name: Publisher - name: Publisher/Publisher Stack - name: Publisher/Publisher Tag - name: Publisher/Publisher Meta - name: Publisher/Experiment - name: Publisher/Config (Ad unit) - name: Publisher/App Placement - name: AI - name: AI/Activity - name: Billing - name: Billing/Invoice - name: Audit Log - name: '[IN PROGRESS] Integration' - name: '[IN PROGRESS] Integration/Mapping' - name: '[IN PROGRESS] User' - name: '[IN PROGRESS] User/Account' - name: public paths: /v1/report/insight/revenue/dimension: get: tags: - Reporting/Insights Hub/Revenue Insights - public summary: /report/insight/revenue/dimension description: >- Revenue and ad delivery broken down by one dimension, such as publisher, ad unit type, country, device or partner. The figures match `/v1/report/insight/revenue`, and rates are worked out the same way: Fill = `impressions ÷ ad_requests`, Ad Server Fill = `ad_responses ÷ ad_requests`, Unit Fill = `ad_responses ÷ ad_unit_loads` parameters: - name: uid in: query description: >- One or more publisher IDs, comma-separated. Defaults to all publishers in your organisation required: false example: '' schema: type: string - name: range in: query description: >- Date range to report on. Preset ranges end yesterday. `month_to_date` is the current month so far and `week_to_date` is the current week so far. `month_on_month` and `quarter_on_quarter` return monthly or quarterly totals, with the latest period incomplete. `custom` requires `start` and `end` (YYYY-MM-DD). Other values return a 400 error required: false example: '' schema: type: string enum: - custom - all_time - seven_days - fourteen_days - thirty_days - three_months - six_months - week_to_date - month_to_date - quarter_to_date - year_to_date - last_week - last_month - last_quarter - last_year - month_on_month - quarter_on_quarter - yesterday - name: start in: query description: Start date when range=custom required: false example: '' schema: type: string format: date - name: end in: query description: End date when range=custom required: false example: '' schema: type: string format: date - name: date_group in: query description: >- Groups the series by day, month or quarter. `month_on_month` and `quarter_on_quarter` group automatically required: false example: '' schema: type: string enum: - day - month - quarter default: day - name: tab in: query description: The dimension to report on required: false example: '' schema: type: string enum: - publisher - ad_unit_type - config - geo - region - device - channel - partner - creative_size default: publisher - name: environment in: query description: Environment or platform to report from required: false example: '' schema: type: string enum: - all - app - web default: all responses: '200': description: '' content: application/json: schema: type: object required: - success - results properties: results: type: object required: - currency - dates - dimension - data properties: currency: type: string description: Currency code all revenue is converted to dates: type: array description: >- Start date of each period in the series, by day, month or quarter items: type: string format: date dimension: type: object description: >- One entry per dimension value, keyed by that value (for example a domain, country or device). Each array lines up with `dates`; null means no data for that period additionalProperties: type: object properties: gross_revenue: type: array items: type: number nullable: true pap_gross_revenue: type: array items: type: number nullable: true saas_gross_revenue: type: array items: type: number nullable: true net_revenue: type: array items: type: number nullable: true pap_net_revenue: type: array items: type: number nullable: true saas_net_revenue: type: array items: type: number nullable: true impressions: type: array items: type: integer nullable: true pap_impressions: type: array items: type: integer nullable: true saas_impressions: type: array items: type: integer nullable: true properties: {} data: type: array description: >- One row per period and dimension value, with revenue and ad delivery figures items: type: object required: - date - dimension properties: date: type: string format: date description: Start date of the period dimension: type: string description: >- Dimension value. Missing values come back as (empty) gross_revenue: type: number pap_gross_revenue: type: number saas_gross_revenue: type: number net_revenue: type: number pap_net_revenue: type: number saas_net_revenue: type: number impressions: type: integer pap_impressions: type: integer saas_impressions: type: integer viewable_impressions: type: integer pap_viewable_impressions: type: integer saas_viewable_impressions: type: integer ad_unit_loads: type: integer pap_ad_unit_loads: type: integer saas_ad_unit_loads: type: integer ad_requests: type: integer pap_ad_requests: type: integer saas_ad_requests: type: integer ad_responses: type: integer pap_ad_responses: type: integer saas_ad_responses: type: integer success: type: boolean example: results: currency: GBP dates: - '2026-10-19' - '2026-10-20' dimension: desktop: gross_revenue: - 412.37 - 398.04 pap_gross_revenue: - 288.66 - 278.63 saas_gross_revenue: - 123.71 - 119.41 net_revenue: - 329.9 - 318.43 pap_net_revenue: - 230.93 - 222.9 saas_net_revenue: - 98.97 - 95.53 impressions: - 158240 - 152611 pap_impressions: - 110768 - 106828 saas_impressions: - 47472 - 45783 mobile: gross_revenue: - 655.12 - 671.8 pap_gross_revenue: - 458.58 - 470.26 saas_gross_revenue: - 196.54 - 201.54 net_revenue: - 524.1 - 537.44 pap_net_revenue: - 366.86 - 376.21 saas_net_revenue: - 157.24 - 161.23 impressions: - 301455 - 309870 pap_impressions: - 211019 - 216909 saas_impressions: - 90436 - 92961 data: - date: '2026-10-19' dimension: desktop gross_revenue: 412.37 pap_gross_revenue: 288.66 saas_gross_revenue: 123.71 net_revenue: 329.9 pap_net_revenue: 230.93 saas_net_revenue: 98.97 impressions: 158240 pap_impressions: 110768 saas_impressions: 47472 viewable_impressions: 104438 pap_viewable_impressions: 73107 saas_viewable_impressions: 31331 ad_unit_loads: 201560 pap_ad_unit_loads: 141092 saas_ad_unit_loads: 60468 ad_requests: 196310 pap_ad_requests: 137417 saas_ad_requests: 58893 ad_responses: 171880 pap_ad_responses: 120316 saas_ad_responses: 51564 - date: '2026-10-19' dimension: mobile gross_revenue: 655.12 pap_gross_revenue: 458.58 saas_gross_revenue: 196.54 net_revenue: 524.1 pap_net_revenue: 366.86 saas_net_revenue: 157.24 impressions: 301455 pap_impressions: 211019 saas_impressions: 90436 viewable_impressions: 189916 pap_viewable_impressions: 132942 saas_viewable_impressions: 56974 ad_unit_loads: 388210 pap_ad_unit_loads: 271747 saas_ad_unit_loads: 116463 ad_requests: 372990 pap_ad_requests: 261093 saas_ad_requests: 111897 ad_responses: 318420 pap_ad_responses: 222894 saas_ad_responses: 95526 - date: '2026-10-20' dimension: desktop gross_revenue: 398.04 pap_gross_revenue: 278.63 saas_gross_revenue: 119.41 net_revenue: 318.43 pap_net_revenue: 222.9 saas_net_revenue: 95.53 impressions: 152611 pap_impressions: 106828 saas_impressions: 45783 viewable_impressions: 100723 pap_viewable_impressions: 70506 saas_viewable_impressions: 30217 ad_unit_loads: 194380 pap_ad_unit_loads: 136066 saas_ad_unit_loads: 58314 ad_requests: 189950 pap_ad_requests: 132965 saas_ad_requests: 56985 ad_responses: 165770 pap_ad_responses: 116039 saas_ad_responses: 49731 - date: '2026-10-20' dimension: mobile gross_revenue: 671.8 pap_gross_revenue: 470.26 saas_gross_revenue: 201.54 net_revenue: 537.44 pap_net_revenue: 376.21 saas_net_revenue: 161.23 impressions: 309870 pap_impressions: 216909 saas_impressions: 92961 viewable_impressions: 195218 pap_viewable_impressions: 136653 saas_viewable_impressions: 58565 ad_unit_loads: 399150 pap_ad_unit_loads: 279405 saas_ad_unit_loads: 119745 ad_requests: 383460 pap_ad_requests: 268422 saas_ad_requests: 115038 ad_responses: 327310 pap_ad_responses: 229117 saas_ad_responses: 98193 success: true headers: {} deprecated: false security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.