> ## 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/ads-txt

> An audit of one publisher's current ads.txt or app-ads.txt file: errors, missing lines, direct and reseller lines by exchange, and whether it is up to date



## OpenAPI

````yaml /openapi.json get /v1/report/insight/ads-txt
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/ads-txt:
    get:
      tags:
        - Reporting/Insights Hub/Ads.txt Insights
        - public
      summary: /report/insight/ads-txt
      description: >-
        An audit of one publisher's current ads.txt or app-ads.txt file: errors,
        missing lines, direct and reseller lines by exchange, and whether it is
        up to date
      parameters:
        - name: uid
          in: query
          description: A single publisher ID
          required: true
          schema:
            type: integer
        - name: environment
          in: query
          description: Environment or platform to report from
          required: false
          schema:
            type: string
            enum:
              - app
              - web
            default: web
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: object
                    properties:
                      domain:
                        type: string
                        description: The publisher's domain
                      source:
                        type: string
                        enum:
                          - web
                          - app
                        description: >-
                          Which file was checked: `web` for ads.txt, `app` for
                          app-ads.txt
                      adstxt_health:
                        type: object
                        properties:
                          managed:
                            type: boolean
                            description: >-
                              Whether the file is generated and managed by the
                              platform
                          file_found:
                            type: integer
                            enum:
                              - 0
                              - 1
                            description: 1 when the file was found at the last check
                          content_type:
                            type: string
                            description: >-
                              Content type the file was served with, such as
                              text/plain
                            nullable: true
                          ci_present:
                            type: integer
                            enum:
                              - 0
                              - 1
                            description: 1 when the file includes the platform's own line
                          up_to_date:
                            type: integer
                            enum:
                              - 0
                              - 1
                            description: 1 when the file has every required line
                          last_updated:
                            type: string
                            description: >-
                              When the file was last checked (YYYY-MM-DD
                              HH:MM:SS)
                          insight:
                            type: object
                            description: Counts across the file
                            properties:
                              total_account:
                                type: integer
                                description: >-
                                  Account lines (exchange, account ID and
                                  relationship), including duplicates
                              total_comment:
                                type: integer
                                description: Comment lines
                              total_direct:
                                type: integer
                                description: Account lines with a DIRECT relationship
                              total_empty:
                                type: integer
                                description: Blank lines
                              total_exchange:
                                type: integer
                                description: Different exchanges in the file
                              total_file_lines:
                                type: integer
                                description: Lines in the file
                              total_issues:
                                type: integer
                                description: Lines with at least one error
                              total_present_lines:
                                type: integer
                                description: Lines that match a required line
                              total_reseller:
                                type: integer
                                description: Account lines with a RESELLER relationship
                            required:
                              - total_account
                              - total_comment
                              - total_direct
                              - total_empty
                              - total_exchange
                              - total_file_lines
                              - total_issues
                              - total_present_lines
                              - total_reseller
                          domain_lines:
                            type: array
                            description: >-
                              Variable lines, such as ownerdomain and
                              managerdomain, lowercased
                            items:
                              type: string
                          missing_lines:
                            type: array
                            description: Required lines that aren't in the file
                            items:
                              type: string
                          unique_errors:
                            type: object
                            description: >-
                              Number of lines with each error type. Only error
                              types that occur are included, so this is empty
                              when there are no errors
                            properties:
                              duplicate:
                                type: integer
                                description: Lines that repeat an earlier account line
                              duplicate_var:
                                type: integer
                                description: Lines that repeat an earlier variable line
                              syntax:
                                type: integer
                                description: Malformed lines
                              invalid_value:
                                type: integer
                                description: Lines with an invalid field value
                              invalid_relationship_type:
                                type: integer
                                description: >-
                                  Lines whose relationship isn't DIRECT or
                                  RESELLER
                            additionalProperties: false
                          exchanges:
                            type: object
                            description: >-
                              Account lines grouped by exchange domain, then by
                              source: the integration that requires the line
                              ('Platform - account name'), 'Tracked Third Party
                              Requirements', or 'Untracked' when nothing
                              requires it
                            additionalProperties:
                              type: object
                              additionalProperties:
                                type: object
                                description: >-
                                  Positions in `lines` (0-based), by
                                  relationship type
                                properties:
                                  direct:
                                    type: array
                                    items:
                                      type: integer
                                  reseller:
                                    type: array
                                    items:
                                      type: integer
                            properties: {}
                          lines:
                            type: array
                            description: Every line of the file, in order
                            items:
                              type: object
                              properties:
                                raw:
                                  type: string
                                  description: The line as it appears in the file
                                comment:
                                  type: boolean
                                  description: Whether the line is a comment
                                formatted:
                                  type: string
                                  description: >-
                                    The line lowercased, without spaces or
                                    comments. Null for blank and comment-only
                                    lines
                                  nullable: true
                                errors:
                                  type: array
                                  description: >-
                                    Problems found on the line. Line numbers in
                                    messages are 0-based positions in `lines`
                                  items:
                                    type: object
                                    properties:
                                      type:
                                        type: string
                                        enum:
                                          - duplicate
                                          - duplicate_var
                                          - syntax
                                          - invalid_value
                                          - invalid_relationship_type
                                      message:
                                        type: string
                                    required:
                                      - type
                                      - message
                                present:
                                  type: boolean
                                  description: Whether the line matches a required line
                                fields:
                                  type: object
                                  description: >-
                                    The parts of an account line. Left out for
                                    variable, blank, comment and malformed lines
                                  properties:
                                    exchange:
                                      type: string
                                    account_id:
                                      description: A number when the ID is all digits
                                      anyOf:
                                        - type: string
                                        - type: integer
                                    relationship_type:
                                      type: string
                                      description: >-
                                        direct or reseller, or the invalid value
                                        found
                                    tag_id:
                                      description: Certification authority ID, when given
                                      anyOf:
                                        - type: string
                                          nullable: true
                                        - type: integer
                                          nullable: true
                                  required:
                                    - exchange
                                    - account_id
                                    - relationship_type
                                    - tag_id
                              required:
                                - raw
                                - comment
                                - formatted
                                - errors
                                - present
                        required:
                          - managed
                          - file_found
                          - content_type
                          - ci_present
                          - up_to_date
                          - last_updated
                          - insight
                          - domain_lines
                          - missing_lines
                          - unique_errors
                          - exchanges
                          - lines
                    required:
                      - domain
                      - source
                      - adstxt_health
                  success:
                    type: boolean
                required:
                  - results
                  - success
              example:
                results:
                  domain: example.com
                  source: web
                  adstxt_health:
                    managed: false
                    file_found: 1
                    content_type: text/plain
                    ci_present: 1
                    up_to_date: 0
                    last_updated: '2026-10-22 06:15:03'
                    insight:
                      total_account: 4
                      total_comment: 1
                      total_direct: 3
                      total_empty: 1
                      total_exchange: 3
                      total_file_lines: 9
                      total_issues: 2
                      total_present_lines: 3
                      total_reseller: 1
                    domain_lines:
                      - ownerdomain=example.com
                      - managerdomain=contentignite.com
                    missing_lines:
                      - appnexus.com, 15666, RESELLER, f5ab79cb980f11d1
                    unique_errors:
                      duplicate: 1
                      syntax: 1
                    exchanges:
                      contentignite.com:
                        Tracked Third Party Requirements:
                          direct:
                            - 4
                      google.com:
                        Google Ad Manager - Content Ignite:
                          reseller:
                            - 5
                      openx.com:
                        Untracked:
                          direct:
                            - 6
                            - 7
                    lines:
                      - raw: OWNERDOMAIN=example.com
                        comment: false
                        formatted: ownerdomain=example.com
                        errors: []
                        present: false
                      - raw: MANAGERDOMAIN=contentignite.com
                        comment: false
                        formatted: managerdomain=contentignite.com
                        errors: []
                        present: true
                      - raw: ''
                        comment: false
                        formatted: null
                        errors: []
                        present: false
                      - raw: '# Content Ignite'
                        comment: true
                        formatted: null
                        errors: []
                        present: false
                      - raw: contentignite.com, 3, DIRECT
                        comment: false
                        formatted: contentignite.com,3,direct
                        errors: []
                        fields:
                          exchange: contentignite.com
                          account_id: 3
                          relationship_type: direct
                          tag_id: null
                        present: true
                      - raw: >-
                          google.com, pub-1234567890123456, RESELLER,
                          f08c47fec0942fa0
                        comment: false
                        formatted: >-
                          google.com,pub-1234567890123456,reseller,f08c47fec0942fa0
                        errors: []
                        fields:
                          exchange: google.com
                          account_id: pub-1234567890123456
                          relationship_type: reseller
                          tag_id: f08c47fec0942fa0
                        present: true
                      - raw: openx.com, 561473087, DIRECT, 6a698e2ec38604c6
                        comment: false
                        formatted: openx.com,561473087,direct,6a698e2ec38604c6
                        errors: []
                        fields:
                          exchange: openx.com
                          account_id: 561473087
                          relationship_type: direct
                          tag_id: 6a698e2ec38604c6
                        present: false
                      - raw: openx.com, 561473087, DIRECT, 6a698e2ec38604c6
                        comment: false
                        formatted: openx.com,561473087,direct,6a698e2ec38604c6
                        errors:
                          - type: duplicate
                            message: Duplicate of line 6
                        fields:
                          exchange: openx.com
                          account_id: 561473087
                          relationship_type: direct
                          tag_id: 6a698e2ec38604c6
                        present: false
                      - raw: appnexus.com, RESELLER
                        comment: false
                        formatted: appnexus.com,reseller
                        errors:
                          - type: syntax
                            message: This line seems malformed
                        present: false
                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.