> ## 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/health-check

> Lists health checks from the last 30 days. A health check is a dated review of a site with an overall score and recommendations



## OpenAPI

````yaml /openapi.json get /v1/report/health-check
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/health-check:
    get:
      tags:
        - Reporting/Health Check
        - public
      summary: /report/health-check
      description: >-
        Lists health checks from the last 30 days. A health check is a dated
        review of a site with an overall score and recommendations
      parameters:
        - name: uid
          in: query
          description: >-
            One or more publisher IDs, comma-separated. Defaults to all
            publishers in your organisation
          required: false
          schema:
            type: string
        - name: range
          in: query
          description: >-
            Date range of health check reports to list. Ranges run up to and
            including today. `custom` requires `start` and `end` (YYYY-MM-DD).
            Other values return a 400 error.
          required: false
          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
              - yesterday
            default: thirty_days
        - name: start
          in: query
          description: Start date when range=custom
          required: false
          schema:
            type: string
            format: date
        - name: end
          in: query
          description: End date when range=custom
          required: false
          schema:
            type: string
            format: date
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    description: >-
                      Health checks dated within the range, oldest first. For
                      internal users, checks still being generated follow at the
                      end
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          description: >-
                            Health check ID, used with
                            /v2/report/health-check/{uid}/{id}. For a pending
                            check this is its queue ID, which has no report yet
                        date:
                          type: string
                          description: >-
                            When the check was created, or queued if still
                            pending (YYYY-MM-DD HH:MM:SS)
                        uid:
                          type: integer
                          description: Publisher ID
                        health_score:
                          type: integer
                          minimum: 0
                          maximum: 100
                          description: >-
                            Overall score out of 100. Null while the check is
                            pending
                          nullable: true
                        domain:
                          type: string
                          description: Publisher's website domain
                        label:
                          type: string
                          description: Publisher label, null when none is set
                          nullable: true
                        public:
                          type: integer
                          enum:
                            - 0
                            - 1
                          description: >-
                            1 when the report is published to the publisher's
                            organisation. Non-internal users only see published
                            reports
                        version:
                          description: >-
                            Report format. Version 2 reports are fetched from
                            /v2/report/health-check/{uid}/{id}
                          type: integer
                          enum:
                            - 1
                            - 2
                        status:
                          type: string
                          enum:
                            - COMPLETE
                            - QUEUED
                            - PROCESSING
                          description: >-
                            COMPLETE for a finished check. QUEUED and PROCESSING
                            checks are only listed for internal users and are
                            not filtered by range or uid
                      required:
                        - id
                        - date
                        - uid
                        - health_score
                        - domain
                        - label
                        - public
                        - version
                        - status
                  success:
                    type: boolean
                required:
                  - results
                  - success
              example:
                results:
                  - id: 1842
                    date: '2026-09-29 10:12:44'
                    uid: 20417
                    health_score: 64
                    domain: example.com
                    label: null
                    public: 1
                    version: 2
                    status: COMPLETE
                  - id: 1857
                    date: '2026-10-14 08:31:05'
                    uid: 20533
                    health_score: 78
                    domain: news.example.org
                    label: Example News
                    public: 1
                    version: 2
                    status: COMPLETE
                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.