List printers

Lists the printers reported by every computer in the organization and mode of the caller. A test key sees the four virtual test printers.

GET /v1/printers

List printers

cURL

curl --request GET \
  --url https://api.printeasy.adfinite.com/v1/printers \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "capabilities": {
        "bins": [
          "Auto",
          "Tray 1"
        ],
        "collate": true,
        "color": false,
        "copies": 99,
        "dpis": [
          "600x600"
        ],
        "duplex": true,
        "extent": null,
        "medias": [],
        "nup": [
          1,
          2,
          4
        ],
        "papers": {
          "A4": [
            2100,
            2970
          ],
          "Letter": [
            2159,
            2794
          ]
        },
        "printrate": {
          "rate": 38,
          "unit": "ppm"
        },
        "supports_custom_paper_size": false
      },
      "computerId": "0192f1a0-7c00-7000-8000-0000000000cc",
      "createdAt": "2026-10-01T08:30:00.000Z",
      "customPapers": [],
      "defaultOptions": {
        "duplex": "long-edge",
        "paper": "A4"
      },
      "description": "HP LaserJet Pro M404-M405 PCL 6",
      "displayName": "Front office laser",
      "enabled": true,
      "id": "0192f1a0-7c00-7000-8000-0000000000bb",
      "isDefault": true,
      "name": "Front office laser",
      "osName": "HP LaserJet Pro M404",
      "remarks": null,
      "state": "online",
      "stateDetail": "",
      "updatedAt": "2026-10-14T09:00:00.000Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Authorizations

ApiKeyAuthBasicAuth

Authorization · string · header · default: pe_test_REPLACE_WITH_YOUR_TEST_KEY · required

Send Authorization: Bearer <API key>. Use a pe_test_ key in the playground; it only reaches virtual test printers.

Query Parameters

limit · integer · default: 25

Required range: 1 <= x <= 100

after · string<uuid>

Cursor: the nextCursor of the previous page

dir · enum<string> · default: desc

desc is newest first; asc is oldest first and suits polling

Available options: asc, desc

Response

200

application/json

A page of printers

data · object[] · required

Show child attributes

hasMore · boolean · required

nextCursor · string | null · required