Penpot

Penpot Get File Stats API

The Get File Stats API from Penpot — 1 operation(s) for get file stats.

GitHub OpenAPI

Operations 1

POST get-file-stats

Documentation

📖
Documentation
https://help.penpot.app/technical-guide/integration/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/penpot/refs/heads/main/openapi/penpot-get-file-stats-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/penpot/refs/heads/main/json-schema/penpot-schemas.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/penpot/refs/heads/main/examples/penpot-request-examples.json
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/penpot/refs/heads/main/vocabulary/penpot-vocabulary.yml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/penpot/refs/heads/main/json-ld/penpot-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/penpot-get-file-stats-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

penpot-get-file-stats-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: '2.16'
  title: Penpot RPC Add Team To Organization Get File Stats API
  description: Penpot RPC-style REST API for projects, files, pages, components, and design assets.
  x-api-id: penpot-rpc
  contact:
    url: https://community.penpot.app/
    name: Penpot Support
  x-humanURL: https://penpot.app/integrations-api
servers:
- url: https://design.penpot.app/api/main/methods
  description: MAIN API
tags:
- name: Get File Stats
paths:
  get-file-stats:
    post:
      description: '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.'
      deprecated: false
      requestBody:
        required: true
        content:
          application/json:
            schema:
              title: get-file-stats
              type: object
              properties:
                id:
                  $ref: '#/components/schemas/Uuid'
              required:
              - id
            example: '{"id":"5ab5eb30-5b3a-81d5-8008-2a395c77c4e8"}'
      responses:
        default:
          description: A default response
          content:
            application/json:
              schema:
                title: FileStats
                type: object
                properties:
                  fileId:
                    $ref: '#/components/schemas/Uuid'
                  pageCount:
                    title: integer
                    description: integer
                    type: integer
                    minimum: 0
                  shapeCounts:
                    title: FileStatsShapeCounts
                    type: object
                    properties:
                      total:
                        title: integer
                        description: integer
                        type: integer
                        minimum: 0
                      byType:
                        type: object
                        additionalProperties:
                          title: integer
                          description: integer
                          type: integer
                          minimum: 0
                    required:
                    - total
                    - byType
                  componentCount:
                    title: integer
                    description: integer
                    type: integer
                    minimum: 0
                  deletedComponentCount:
                    title: integer
                    description: integer
                    type: integer
                    minimum: 0
                  colorCount:
                    title: integer
                    description: integer
                    type: integer
                    minimum: 0
                  typographyCount:
                    title: integer
                    description: integer
                    type: integer
                    minimum: 0
                  libraryCount:
                    title: integer
                    description: integer
                    type: integer
                    minimum: 0
                  referencedByCount:
                    title: integer
                    description: integer
                    type: integer
                    minimum: 0
                  revn:
                    title: integer
                    description: integer
                    type: integer
                    minimum: 0
                  updatedAt:
                    $ref: '#/components/schemas/Inst'
                required:
                - fileId
                - pageCount
                - shapeCounts
                - componentCount
                - deletedComponentCount
                - colorCount
                - typographyCount
                - libraryCount
                - referencedByCount
                - revn
                - updatedAt
              example: '{"pageCount":39649,"updatedAt":"2026-06-12T12:36:02.607049080Z","shapeCounts":{"total":8,"byType":{"+M:z+v":88941,"qW!q*":45022,"Z1.-e":35046,"xDM*_":3654598,"ce1UdL?_":0,"Zxga9+8!":1475687,"c.":3,"!.K_":125507,"QbK.-d":1590053,"+a!?":13,"aA":2,"-":15435876,"!e+4":299422,"-c2P.P2x":310216,"Y":0,"?":71540,"E?!":18204,"g_x+Dep":2747150,"X+v":5,"!L+3.F":304148327,"fD*x":2,".W":162,"CizN":63800,"z9+?zO":124211610,"?Q+-c":0,"M:5H":1796412,"rD":847,"xYR2":1032277,"?P!MAA-k":2}},"fileId":"5ab5eb30-5b3a-81d5-8008-2a395c7809bd","deletedComponentCount":48367275,"revn":6013337,"referencedByCount":0,"typographyCount":18,"componentCount":1348,"colorCount":3,"libraryCount":14}'
      tags:
      - Get File Stats
components:
  schemas:
    Inst:
      title: instant
      type: string
      format: iso
    Uuid:
      title: uuid
      description: UUID formatted string
      type: string
      format: uuid