---
title: "POST get-file-stats"
method: POST
path: "get-file-stats"
---

# POST get-file-stats

`POST get-file-stats`

Return aggregate statistics for a single file: page count, shape
counts by type, component/color/typography counts, and inbound and
outbound library reference counts. Cheap alternative to `get-file`
when only metrics are needed.

## Request body

- object
  - `id` string, uuid, required — UUID formatted string

## Response `default`

A default response

- object
  - `fileId` string, uuid, required — UUID formatted string
  - `pageCount` integer, required — integer
  - `shapeCounts` object, required
    - `total` integer, required — integer
    - `byType` object, required
  - `componentCount` integer, required — integer
  - `deletedComponentCount` integer, required — integer
  - `colorCount` integer, required — integer
  - `typographyCount` integer, required — integer
  - `libraryCount` integer, required — integer
  - `referencedByCount` integer, required — integer
  - `revn` integer, required — integer
  - `updatedAt` string, iso, required

---

[API](https://skmtc.net/penpot/apis/untitled-api.md) · [All operations](https://skmtc.net/penpot/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/penpot/untitled-api/versions/6440f0b9dfc1/schema)