---
title: "List the current user's printers."
method: GET
path: "/api/Printers/summary"
tags: ["Printers"]
---

# List the current user's printers.

`GET /api/Printers/summary`

## Request

- Base URL: `https://api.3dprintlog.com`
- URL: `https://api.3dprintlog.com/api/Printers/summary`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://3dprintlog.auth0.com/authorize`, token URL `https://3dprintlog.auth0.com/oauth/token`)
  - API key in header `X-Api-Key`
  - API key in query parameter `api_key`

Inactive printers are left out unless `includeInactive=true`. Use a printer's `id` as the
`printerId` when creating a print.

## Query parameters

- `PageNumber` integer
- `PageSize` integer
- `searchText` string
- `includeInactive` boolean

## Response `200`

Returned with a paged list of printer summaries.

- PrintLogApiModelsDTOsPrinterPrinterSummarySimpleDto[]
  - `id` integer
  - `name` string, nullable
  - `make` string, nullable
  - `model` string, nullable
  - `isActive` boolean
  - `wattageW` number, double, nullable
  - `slotCount` integer: How many filament positions the printer has. 1 for a single-tool printer.
  - `category` PrintLogApiModelsDTOsPrinterCategoryPrinterCategoryDto: The class/category/type of 3D printing technology, such as FDM, SLA, etc
    - `nickname` string, nullable: The nickname of the category
    - `name` string, nullable: The long form name of the category
    - `description` string, nullable: A description of that category
    - `materialCategory` PrintLogApiModelsDTOsMaterialCategoryMaterialCategoryDto: The category of materials, such as filament, resin, powder, etc.
      - `nickname` string, nullable: The nickname of the material category
      - `name` string, nullable: The long form name of the category
      - `description` string, nullable: A description of that category
      - `hasDiameter` boolean: Whether this material has a diameter
      - `showNozzleTemperature` boolean
      - `showBedTemperature` boolean
      - `showMeltingTemperature` boolean
      - `showRecommendedInitialLayerTimeInSeconds` boolean
      - `showRecommendedLayerTimeInSeconds` boolean
      - `showMaterialRefreshRatio` boolean: The percentage of new powder when mixing with old powder
      - `showInertGas` boolean
    - `showNozzleDiameter` boolean
    - `showFilamentDiameter` boolean
    - `showBeamDiameter` boolean
    - `showBedSize` boolean
    - `showScreenResolution` boolean
    - `showHasHeatedBed` boolean
    - `showHasHeatedChamber` boolean
  - `loadedFilaments` PrintLogApiModelsDTOsPrinterPrinterFilamentForSummaryDto[], nullable
    - `id` string, uuid
    - `slot` integer, nullable: The 0-based slot the spool is in, or null when it was loaded without one.
    - `slotLabel` string, nullable: What the printer calls the slot, such as `T2`.
    - `loadedAt` string, date-time: When the spool was loaded.
    - `filament` PrintLogApiModelsDTOsFilamentFilamentSummaryForPrinterDto: Minimal filament summary for printer display lists. Excludes expensive calculated fields (remaining weight/volume/length) to improve query performance.
      - `id` string, uuid
      - `displayName` string, nullable: Common name for the roll of filament.
      - `brand` string, nullable
      - `materialType` string, nullable: The material Type, ie PLA, PETG, ABS.
      - `colorName` string, nullable
      - `colorHex` string, nullable
      - `colorPattern` 1 | 2 | 3 | 4: Sent as an integer: `1` = Solid, `2` = Multi, `3` = Gradient, `4` = Rainbow.
      - `colors` string[], nullable
      - `finishType` 1 | 2 | 3: Sent as an integer: `1` = Standard, `2` = Silk, `3` = Matte.
      - `effects` PrintLogApiEnumsFilamentEffect[], nullable
  - `defaultImageThumbnailUrl` string, nullable: Signed thumbnail URL for this printer's default photo. Populated per-request, AFTER the cache read - a signed URL cached for the entry's lifetime would outlive its signature.

## Other responses

- `401`: Returned if the user is not authenticated.
- `403`: Forbidden

---

[API](https://skmtc.dev/3dprintlog/apis/3d-print-log-api.md) · [All operations](https://skmtc.dev/3dprintlog/apis/3d-print-log-api/llms.txt) · [OpenAPI document](https://skmtc.dev/3dprintlog/apis/3d-print-log-api/revisions/dfc3a4df4e38?raw)