---
title: "Get diagrams with stats"
method: GET
path: "/clouddiagrams/v1/scheme/stats"
tags: ["Cloud Diagrams"]
---

# Get diagrams with stats

`GET /clouddiagrams/v1/scheme/stats`

Returns a list of all diagrams with activity stats for the given time period.

## Query parameters

- `start` string, date-time, required
- `end` string, date-time, required

## Response `200`

OK - List of diagrams with stats returned.

- CloudDiagramStats[]
  - `_id` string — ID of the diagram.
  - `ss_id` string — ID of the layer the diagram belongs to.
  - `name` string — Name of the diagram.
  - `type` 'application' | 'infrastructure' | 'network' | 'template' — Type of the diagram.
  - `account_name` string — Cloud account name.
  - `account_id` string — Cloud account ID.
  - `account_type` string — Cloud account type.
  - `changes` CloudDiagramStatsChange[] — Activity changes within the period.
    - `type` 'NODE_CREATE' | 'NODE_UPDATE' | 'NODE_DELETE' — Type of the change.
    - `service` string — Cloud service the change applies to.
    - `count` integer — Number of occurrences of this change type.
  - `import` CloudDiagramImportState — Current import/sync state for a cloud-connected diagram.
    - `status` 'queued' | 'in_progress' | 'success' | 'failure' — Import status.
    - `type` 'AWS' | 'GCP' | 'AZURE' — Connected cloud account type.
    - `account` string — Connected account ID.
    - `cloudId` string — Cloud account ID.
    - `errorMessage` string — Error message if the import failed.
    - `syncedAt` string, date-time — Timestamp of the last successful sync.

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)
