---
title: "The audit-compliance dashboard's headline numbers"
method: GET
path: "/api/dashboard-analytics/audits-metrics/{companyId}"
tags: ["Dashboard Analytics/Audits Metrics"]
---

# The audit-compliance dashboard's headline numbers

`GET /api/dashboard-analytics/audits-metrics/{companyId}`

## Request

- Base URL: `https://api.retraced.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.retraced.com/api/dashboard-analytics/audits-metrics/{companyId}`
- Auth: none declared

For the company's network: its suppliers, the unexpired latest audits and the companies holding them, the audits planned between today and the end of next month, and the audits by standard and by type dated between `startDate` and `endDate` (the past year without both). `filter` is a JSON-encoded `AuditMetricsFilter`; its lists narrow every count. Days are read in the `x-timezone` header's timezone (UTC without it). Only the company itself or Retraced staff may read it.

## Path parameters

- `companyId` string, required

## Query parameters

- `filter` string

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required: True when the request succeeded.
  - `data` object, required
    - `auditsByStandard` object, required
      - `data` object[], required
        - `auditStandardId` string, required
        - `auditStandardName` string, required
        - `count` number, required
      - `totalCount` number, required
    - `auditsByType` object, required
      - `data` object[], required
        - `auditType` string, required
        - `count` number, required
      - `totalCount` number, required
    - `totalCompanies` number, required
    - `totalCompaniesWithAudits` number, required
    - `totalAudits` number, required
    - `totalAuditsPlannedNextMonth` number, required
    - `percentageOfSupplierWithAudits` number, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response

## Changes

> 108 revisions in range; 2 not diffed.

- **2026-10-13** `b9cf8bef8ed3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/retraced/apis/api-reference/changes/api/dashboard-analytics/audits-metrics/:companyId/get.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) - [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/retraced/apis/api-reference/revisions/83309c4abd20?raw)